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Section 1 
INTRODUCTION 


The CGOS 200 GNA Operator Guide serves a dual purpose. It is designed 
to introduce routine system interactions and to be a concise reference 
source for the experienced system user. This release of the Computervi- 
sion Graphics Operating System (CGOS 200) supports Graphic Network- | 
ing Architecture (GNA) and up to 10 user tasks. 


A Table of Contents, Index, and Glossary provide quick reference to 
material throughout this publication. This Guide is divided into four 
sections: 


e Section 1 Highlights the Designer V and CV environment. 


® Section 2 Introduces system software operation and references 
the system’s Special Characters. 


¢ Section 3. —_— Provides a brief command description of all system com- 
mands and lists the most commonly used operator com- 
mands. 


e Section 4 Appendix definition of Error Codes and Messages. 


Due to on-going hardware and software enhancements, some information 
in this manual may be superseded. Extensive, up-to-date documentation is 
stored on-line. On-line documentation is accessed with the HELP com- 
mand. (See HELP, Section 3, for additional documentation. ) 


A complete list of CV Publications is available by contacting your CV 
representative. This list includes brief descriptions, prices, and recom- 
mended quantities for purchase of current user publications. 


Different type sizes and faces are used to distinguish between system and 
user responses. 


Exact Variable 
User Input ALL CAPS Upper and Lower-case 
System Output © ALL CAPS, SMALL Upper and Lower-case 
| TYPE FACE Small Type Face 
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PRODUCTIVITY 
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CV T.I.P.S. 


BUG 
REPORTING 
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Symbol Meaning 
Other 
Conventions » Carriage return. 
n> Operating System (0O/S) 
level prompt for input. 
[ ] Optional material. 
:} Choose between two or 
more items. 


Technical training instruction is given at the Services Training Center, 
Woburn, Mass, and at CV Education Centers in Chicago and Los Angeles. 
Application Engineers and professional instructors are also available to 
come directly to your company. The current listing of courses, available in 
a quarterly brochure, Educational Services Course Schedule, is obtainable 
through the Educational Centers Registrar (617)935-9723. 


CV Productivity Services, available on a contract basis, focuses on the effi- 
ciency with which your Designer System is being operated, and its cost- 
effectiveness for your product. 


A two to three day, on-site review of your system in operation consists of 
operations personnel interviews, and investigations of your programming 
and operating system environment, overlay structures, file catalogs, and 
communications with mainframe computers. Resulting recommendations 
might include suggestions for improving operating procedures, making 
tasks more cost-efficient, and choosing/training more effective super- 
visors, Operators, and other personnel. 


A quarterly publication, Techniques for Increasing Productivity on the 
System, is available for all Computervision systems users at no extra cost. 
For additional information regarding a T.I.P.S. subscription, and submittal 
of T.I.P.S. material, contact your CV representative. 


To report a software bug, please call the Response Center in 
Woburn, Massachusetts, 800-225-5376 or 617-935-9723. A dispatcher will 
take the information and an applications engineer will return your call, nor- 
mally within four hours, to discuss your problem. Each month you will 
receive a status report of all your software-related calls to the Response 
Center. 


DESIGNER 
SYSTEM 


CGP-200 


Storage Module 


Instaview 
Workstation 
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The Designer System is designed to work optimally with the CGOS 200 
GNA. It is composed of the following interactive components. 


The CGP-200 performs all data calculations and interactive control func- 
tions. It consists of a graphics processor and a magnetic tape unit. 


e Graphics Processor 


A high-speed data manipulation and storage device that controls all 
Designer System operations. It contains controllers for the Design 
Console and all CV input/output devices. 


The Central Processor Unit (CPU) is micro-program controlled. Inter- 
nal Read Only Memory (ROM) chips. contain firmware (a 
microprogram) that is activated by program instructions. 
Microprogramming permits simultaneous execution of CPU func- 
tions, giving much faster processing of program instructions than 
conventional CPUs. Simplified operator controls and state-of-the art 
microprogrammed circuitry assures ease of operation, fast response 
for users, simple field up-grading, and increased system reliability. 


Associated with the CPU is a memory board, capable of storing 
32,768 17-bit words: 16 bits of data, one parity bit. The memory 
Capacity, depending on the configuration, is expandable to 640K 
words with the Memory Mapping and Protection Unit (MMP) and 
additional memory boards. The CGOS supervises all system resources 
and uses 80K of memory. Each user or task uses 46K of memory. 
Current CGP configurations accommodate as many as 8 interactive 
graphic users on the CGOS 200 GNA system. 7 


e Magnetic Tape Unit 


Used to write and store design information entered into the system. 
Once stored on tape, information can always be read back into the 
system. 


An 80 or 300-megabyte disc unit is used for storing design information. 
The unit records onto a multi-surfaced disc pack. CGOS is stored on a 
protected portion of this disc. 


The typical workstation consists of a 19-inch cathode ray tube (CRT) 
display, a graphics tablet with pen, a keyboard, and a printer. It is con- 
figured, on the CADDS 3 or 4 system, to be used with a graphics tablet or 
a CVD-4 (CV Digitizer). Menuing and continuous digitizing are features 
that enhance the productivity of the workstation. 
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e CRT Display 


Used for designing, editing, and evaluating graphic drawings. After all 
insertions, deletions, and modifications are made, the design may be 
plotted on the plotter or stored for future use. 


CRT digitizing is accomplished by using an electronic pen in conjunc- 
tion with a graphic tablet. The position of the pen appears as an 
intersection of two lines (crosshair) on the display screen. 


+ mazaA Dan 
l uu of Gil 


| 
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Used for design input, data editing, and command menu selection. 

_ When the pen’s tip is within one quarter inch of the tablet’s surface, 
the pen’s motion moves the cursor on the display screen. Pressing a 
button on the pen digitizes the point on the display indicated by the 
cursor. 


e Printer 


Provides permanent, dry copies of any information displayed by the 
INSTAVIEW terminal. 


19/G Workstation The typical 19/G Workstation consists of a 19/G Design Console 
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(Graphics Display Storage Terminal), a design pen and tablet, and either a 
Teledisplay or Telewriter Il Unit. Menuing and continuous digitizing are 
features to enhance the productivity of the workstation. 


e Graphics Display Storage Terminal 


This interactive, storage tube graphics display terminal is designed for 
use as a graphics workstation or as an echo display for the Interact IV 
and the CV Digitizer. 


e Design Pen and Tablet 


The Design Pen and Tablet are used in conjunction with the 19/G 
Design Console for data input, data editing, and menu selection. The 
pen is used to position the cursor on the Graphics Display Terminal 
and to input digitized data. The top half of the tablet is divided into 
squares that can be assigned a single command, text, or group of 
commands which are initiated by pressing the pen down within the — 
appropriate menu square. This action digitizes, that is, records the 
point on the Display Terminal indicated by the cursor. 
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19/G Workstation e Telewriter II 


(Continued) 


Additional 
Design System 
Components 


A typewriter-style keyboard and hardcopy printer. The unit is used for 
entering design commands, printing system error messages, system 
prompts, and general information. It produces an audible tone to 
indicate improper or illegal commands. 


e Teledisplay 


A character-oriented, data entry/display terminal used for entering 
commands, displaying system error messages, system prompts, and 
general information. 


e Instaview-C 


CV's color display graphics terminal . As an intelligent graphics terminal, 
the Instaview-C uses a high-resolution color raster CRT display to 
provide enhanced graphic discrimination capabilities. Up to 64 colors 
can be used to differentiate graphic information. The basic console 
design and manipulation capabilities of the non-color Instaview work- 
station are incorporated. 


e P-1000 


This portable, high-speed pen plotter accepts very long drawings and 
continuous plots. The P-1000 can plot on pre-printed forms, continuous 
roll, single sheet, and other standard drafting media. 


e¢ Compucircuit 150 
CV’s high-speed precision photoplotter. 
e CV Digitizer 4 (CVD-4 and Instaview-D) 


The CVD-4 incorporates text only; the Instaview-D incorporates both 
graphics and text. Both provide a micro-processor controlled, high 
resolution, high accuracy, free cursor, absolute position digitizing 
surface. They can be interfaced to the Designer System as either a 
stand-alone user station, or used in conjunction with a Design Console. 
The CVD-4 and Instaview-D offer the choice of either a pen or puck 
input. Their digitizing surfaces are 38 inches by 48 inches. Both are 
tiltable with adjustable backlighting. 
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© Digitizing Puck (for CVD-4 and Instaview-D) 


This standard digitizing ‘‘pointer’’ is connected to the CVD-4 or 
Instaview-D with a lightweight, flexible cable. As a digitizing cursor, the 
puck aids graphics precision and can be more convenient for close work 
than the pen. The “‘pointer’’ is a cross-hair reticle. Its position appears as 
an intersection of two lines (crosshair) on the display screen. Five but- 
tons are mounted on the puck: one for digitize, one to enter and leave 
Stream Mode (implemented through system software), and the others 
assignable through the system software. Three LED lights are also on 
the puck: one to indicate proximity of puck to surface, one for Stream © 


Mode, and the third assignable. 


Contact a CV sales representative for details on various paper tape 
punches and readers, interactive terminals, communications paupinen 
and storage units. 


¢ Calcomp 960 Pen/Plotter 


Used to plot high-resolution drawings. This unit performs a plotting 
function only; it is not an interactive device. 


CGOS 200 GNA supports all CADDS 3 and CADDS 4 application 
packages. Some of the packages available are: 


ACE (Architecture and Civil Engineering) 
MDD (Mechanical Design and Drafting) 

NC (Numerical Control) 

PC/ES (Printed Circuits/Electrical Schematics) 
Wiring Diagrams 


Contact your CV representative for a complete list of available software 
application packages. 
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Communications CGOS 200 GNA can communicate with other CV and non-CV systems. 


Support 


CGOS 200 GNA supports a number of communications packages. For 
data transfer between CGOS 200 systems, Graphic Networking Architec- 
ture (GNA) and CVNET are available. For data transfer between CV 
systems and other systems, CGOS 200 supports 2780, HASP, Honeywell 
GRTS, Univac 1004, and Sigma 7 protocols. These products require a pro- 
grammable communications unit (PCU) for their operation. Further details 


are available upon request. 
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Section 2 


THE OPERATING SYSTEM 


CGOS 200 GNA is a graphics-oriented, multi-user, multi-programming 
operating system developed by Computervision (CV). Supporting CADDS 
3and CADDS 4 interactive graphics CAD/CAM applications, it uses CV's 
Graphics Processor, the CGP-200. 


CGOS 200 GNA is characterized by the following: 


PROGRAMMING 


SUPPORT 


Text Editors 


Programming 
Languages _ 


On-line software development aids. 
Multi-user operation of up to eight interactive graphic workstations. 
Sophisticated file management/command processing system. 


Input/Output system designed to interact with and support a large 
variety of graphics and standard peripheral I/O devices. 


Extensive CPU to CPU communications, including Graphics Network- 
ing Architecture (GNA). 


CGOS supports three text editors for creating and modifying source files. 


EDIT — A simple, line-oriented editor for inputting text. 


LONGEDIT —A _line-oriented editor that handles up to 


256-character line lengths. 


CVTECO — A powerful, character-oriented editor. 


(See EDIT, LONGEDIT, and CVTECO commands, Section 3.) 


FORTRAN-S — A subset of ANSI STANDARD FORTRAN. 


TPL 


— A _ high-level procedural language used for CV 
systems programming. TPL can go into assembly 
language when direct control of machine code is 
required. 
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The Compiler 


The Loader 


Debugging Aids 


Multi-User 
Environment 


BATCH 
PROCESSING 


EXECUTE FILES 


SYSTEM 
COMMANDS 


Login /Accounting 
Login Option 


Compiles a FORTRAN or TPL source file. 


Links and loads files of object code. The result is an overlay containing the 
absolute binary code to be executed at runtime. 


A symbolic subroutine trace is supported for runtime debugging along 
with a debugger designed for application use. (Gee DEBUG and TRACE 
command documentation in the CGOS 200 GNA Programmer Reference 
Manual.) 


CGOS 200 GNA supports up to eight user tasks in the foreground and two 
more tasks in the background; making up to 10 tasks simultaneously 
operable. Processor time is priority-allocated. Short, interactive requests 
are allocated small amounts of CPU time; CPU-bound tasks get larger 
amounts of time at less frequent intervals. : 


Background processing support is provided on a resource-available basis. 
The system maintains a queue for batch jobs. The jobs receive CPU time 
depending on priority and the overall system load. Any Execute File can be 
submitted for batch processing. Batch processing commands are 
summarized in Batch/Execute File Processing Commands, Section 3. 


Generally, O/S commands are entered from the command device 
(COMDEV). To automate the process of entering a repetitive series of 
commands, an Execute File may be used. An execute file is a standard text 
file containing system commands. Execute files can invoke other execute 
files or batch programs. 


CGOS 200 GNA command syntax is very similar to CADDS command. 
There are over 100 standard system commands that an opertor trained on 
a CADDS system can similarly use. Standard conventions facilitate the 
addition of new commands to suit specific needs. Users can develop and 
implement their own commands on a single-user or system-wide basis. 
(See Section 3 for brief descriptions of system commands.) 


After the system has been booted up from disc, you may Login to a sys- 
tem task. (The left column outlines the procedure; the right column 
clarifies the interaction.) 
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Login/Accounting CTRL-L (or CTRL-Rn) 


Login Option 
(Continued) 


**FMCLEAR** 


**TASK n INITIATED** 


n> 


Key-in either command, depending on the 
task number you want to access: 


© CTRL-L — 


e CTRL-Rn — 


after bootup.) 


used in most cases; the 
Login procedure assigns you 
the next available task. 


used to Login to a specific 
pecific task. Type in CTRL-R 
followed by n (n = desired 
task number. Your terminal 
is assigned as the command 
I/O device (COMDEV) for 
the task. 


NOTE: the system does not 
respond to a larger task 
number than the number of 
tasks available, or a task 
number that is already 
logged in. 


If you are the first person to log in after the system 
is booted up, this message appears. See FMCLEAR 
command or response to FMCLEAR output. 


Output when Login is complete and the task is 
ready to use the system. (n = task number assigned 
to you.) 


System prompt. The task is ready to accept 
command input. If file management is enabled, the 
system attempts to execute the first file in a hier- 
archy of user-created execute files, if any exist: 


1. SYSEXEC.BOOT-UP (Only for the first Login 


2. USERNAME.LOGINEXEC (username = your 


Login name.) The text file 
USERNAME.LOGINEXEC is executed. 
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FILE STRUCTURE NOT 
FOUND ON DISC 


TYPE BOOT PASSWORD 


INVALID ENTRY, 
RESTART LOGIN 


TYPE TIME AND DATE 
MM-DD-TT(,HH:MM) 


TYPE NAME, NUMBER 


TYPE PASSWORD 
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3. SYSEXEC.LOGINnn (nn = two-digit 
hexadeciaml task number.) Task-specific files 
are only executed for the task numbered nn. 


4. SYSEXEC.LOGIN 


The system executes the first file in the hier- 
archy that exists. When execution is com- 
plete, the system prompt is issued. If file 
management is enabled and none of the files 
exist, or file management is disabled, the 
system prompt (n>) is issued immediately 
after the message: **TASK n INITIATED**. 


If FMINIT was not previously run (new pack) this 
message appears. 


If FMINIT has been run and authorized boot-up was 
selected, you are asked to enter the authorized 
boot-up password. (6 Characters.) 


This message is output if the password entered 
does not match the password specified in FMINIT. 
Restart Login by typing CTRL-L or CTRL-Rn. 


Under FMINIT, you are asked to set the system 
clock. (Based on 24-hour clock, e.g., 1:00 PM = 
13:00.) 


MM = Month hh = hour 
DD = Date mm= minute 
YY = year 


This message is output when system accouting logs 
and system authorize features are enabled. Enter 
name (up to 20 alphanumeric characters), comma, 
and a number (up to 13 digits). 


System response when the system authorize 
feature is enabled. Input a valid password (up to six 
characters). Your password must correspond to the 
system authorize file entry which is associated with 
your name and number As your password is typed, 
the system will echo blanks. 
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INVALID ENTRY This message is output if the password is not valid 
for the given name and number. You must then 
begin again by typing Control L or Control Rn. 


ACCOUNTING The System Manager retains detailed user accounting information 
LOGIN OPTION (on-system time, etc.). If accounting is enabled, the account's usage logs 
(as given by the account name and number) will be activated. Sections 3 
and 6 of the CGOS 200 GNA System Manager Guide contain detailed 


information. 

LOGOUT / 

Autologout 

LOGOUT The user can LOGOUT manually or under certain circumstances be logged 
out automatically. 

n> LOGOUT Enter command. 

MINS. ELASPED: COST: When authorized Login or accounting Login its 
enabled, the system responds with the time elapsed 
since Login and the cost for time used. 

**TASKn TERMINATED** This is the final system response in all configura- 
tions. 

All units attached to the task are released and the task is terminated. 

In order to access the system again, the user must perform a Login. 

AUTOLOGOUT The Autologout feature is set by the System Manager at BLDSYS time. If 


Autologout is enabled, the system will will log you out if your task is left 
idle at O/S level for 15 minutes. With Autologout disabled, there is no limit 
to idle time. Your task will only be logged out in response to the LOGOUT 
command. 
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To interrupt task execution, enter an ESCAPE or CTRL-B from your 
COMDEV. Printing on the COMDEV or HARDEV will temporarily be 
halted. Your task is now in a wait state. To exit from the wait state or con- 
tinue waiting, type one of the characters depicted in the table that follows. 
Each character triggers a specific action. ve 


Character _ Action 

AP Toggles HARDEV on/off; continues to wait. 

AU Toggies COMDEV on/of; continues to to wait. 

AB Continues to wait. 

ESCAPE Continues to wait. 

Q Aborts the command and escapes to system 
level. 

N Aborts the command, returns to O/S level, and 


terminates an EXECUTE file in progress. 


K Aborts the command and escapes to system 
level. 
1-9 The specified number of lines are output. The 


system then re-enters the Interrupt Wait State. 


P Outputs a page. (Lines per page is device depen- 
dent.) The value for each device is one of the 
configuration parameters for the device. 


(Other) Task continues normal execution. 


Common I/O devices (magnetic tapes, line printers, card readers, paper 
tape readers/punches, graphics and alphanumeric terminals, plotters, and 
data communication devices) are easily attached to any task. Once 
attached, devices may be accessed and controlled by commands entered 
at O/S level. CGOS supports no-wait //O, which gives you the capability 
for entering commands from your task while |/O affecting your task is in 
progress. To access I/O devices, the system supports certain standard 
naming conventions. 


I/O Device 
Names 


TO ASSIGN 
TASKUNITNAME 


SPECIAL CASES 
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Every tape unit and auxiliary device in the system can be referred to by one 
of three names: 


e Unittype A generic four-character name for a class of units 
(e.g., TAPE, IOSB, INFO, TTYS, TBIO, TRMN). 


e Uniqname A unique four-character name for each device (e.g., 
INFO, INF1). 


e Taskunitname A two-character, user-assigned name for a device of 
exclusive access. 


A device must have a Taskunitname before it can be used. Use the 
ATTACH command to assign a Taskunitname to the device you wish to 
use. 


Example 
ATTACH CR,IOSB Attaches IOSB (name CR). 
ATTACH TT,TTYS Attaches teletype (name TT). 


Once the device has been attached, use the Taskunitname to access the 
device from a system command. 


Example 


SELECT HARDEV=TT Make device TT the HARDEV. 


DETACH TT Detaches unit TT. 
RENAMDEV PT,CR Renames device PT; (new name CR). 
CM : No device may be named CM. Any com- 


mand using CM accesses COMDEV (your 
terminal or command device). 


SD The terminal you Login on is named SD by 
the Login process. — 
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SPECIAL CASES MT Mag tapes are usually named MT. Any 
(Continued) system command needing a tape unit name 
assumes MT unless you supply another 
name. 
Example: 


ATTACH MT, TAPE Attaches tape. 
REWIND MT Rewinds tape. 
REWIND Rewinds tape. 


Special Function CGOS uses the ASCII character set. When you type characters on your 

Characters COMDEV, CGOS uses ASCII values to translate them to machine-readable 
binary code. This section describes the ASCII character set, location of the 
keyboard characters, and special function characters. 


Character positioning varies from keyboard to keyboard. Character key 
positions are described for each of the following CV devices: 


TTY Teletype (ASR-33) 

INFO Infoton 

DEC Decwriter or Decscope (VT50) 
LEAR Lear Siegler (ADM-3A) 

lIOSB Telewriter 

INST INSTAVIEW Keyboard 


The Decwriter and Decscope keyboards are similarly arranged. The 
Decscope lacks certain keys (Repeat, and all lower-case characters) that 
the Decwriter has. 


TO TOGGLE Output can be directed to either the command device (COMDEV), the 
OUTPUT hard-copy device (HARDEV), or both. 


e CTRL-P toggles the HARDEV. 


e CTRL-U toggles the NOPRINT switch (on or off) for the COMDEV. 


SPECIAL Applicable special function characters are listed and described in the table 
FUNCTION that follows. 

CHARACTER 

TABLE 
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SPECIAL Key Location Action 

FUNCTION a 

CHARACTER SHIFT Lower left and lower To type any SHIFT, SHIFT key 
TABLE right must remain depressed while 
(Continued) striking character key (e.g., to 


type shift-N, depress SHIFT and 
strike N simultaneously). 


CONTROL Middle left Similar to SHIFT. To type a 

(CTRL) (CTRL) control character, 
depress CTRL key while striking 
character key. To type CTRL- 
SHIFT key, depress both CTRL 
and SHIFT while striking 
character key. In this documen- 
tation, a control character is 
represented by an up arrow (4) 
before the character (e.g., AA 
means CTRL-A). 


SHIFT lIOSB: just above SHIFT After hitting SHIFT LOCK, the 

LOCK INST: just above SHIFT keyboard just above SHIFT 
transmits only SHIFT characters. 
SHIFT condition is cleared by 
striking the SHIFT key. IOSB: 
SHIFT lock condition on when 
IOSB powered up. 


CAPS LOCK DEC: just above SHIFT CAPS LOCK transmits A - Z as 
uppercase. 


BREAK Far right Do not strike this key. Useful 
| only on half-duplex systems to 

cause break in output. If 

accidentally struck and terminal 

appears to die, Use AB (see 


below). 
REPEAT TTY: middle right When REPEAT key is held down, 
INFO: middle right any other depressed key will 
DEC: lower right transmit multiple times. 
LEAR: lower right 
INST: auto repeat 
A@ CTRL-@ Null (not used). 
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SPECIAL Key 

FUNCTION 

CHARACTER 

TABLE 

(Continued) 
AB 
AC AC 
AD 
AG 
AH 
Al 


Location 


CTRL (4) Letters 


Break Character 


2 CTRL-C’s 
(consecutive) 


CTRL-D 


CTRL-G 


CTRL-H 


CTRL-I 


Action 


Only those characters listed below have a special significance. 


When an application program 
finds this character, a break-type 
action should occur. If typed 
during COMDEV or HARDEV 
output, Interrupt Wait State is 
entered. 4B is intercepted by 
the input device handler and will 
never be put into the task input 
stream. 


TASKILL. Aborts all active task 
|/O; returns task to system level. 


CAUTION: TASKILL is_ in- 
tended to be an emergency 
abort. It does not cleanup files or 
return a task to its pre- 
determined state. Whenever 
possible use ESC-Q, etc. 


Toggles the DEBUGGER if the 
DEBUG or TRACE command has 
been specified. (See DEBUG and 
TRACE command documenta- 
tion, CGOS 200 GNA Program- 
mer Reference Manual.) 


Rings bell (won't echo). 


Backspaces. Software treats 
AH like a rubout; j.e., it deletes 
the last character you typed in. 
TTY: does not move the print 
head. 

INFO: moves cursor to upper 
left-hand corner. 


Performs a tab. 
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SPECIAL Key 

FUNCTION 

CHARACTER AJ 

TABLE 

(Continued) 
AL 
AM 
AQ 
AP 


CTRL-J 

DEC: middle right 
LEAR: middle right 
lIOSB: SHIFT-: 
INST: middle right 


CTRL-L 


CTRL-M 


CTRL-O 
(CTRL, Shift 0) 


CTRL-P 


Action 


Performs a line feed (will not 
echo). 


Form Feed. When typed on ter- 
minal not attached to any task, 
will Login as next available task 
and attach COMDEV as the 
keyboard device. It has a device 
dependent effect: INFO: erases 
the screen LINE PRINTER: page 
eject (form feed). 


NOTE: AL is part of the core 
constant. If the above actions 
occur while an undebugged pro- 
gram is running, it is probably 
printing out core constants. 


Carriage Return, signaling. an 
end of line. It echoes as a car- 
riage return followed by a line 
feed. 


LEAR: locks the keyboard (you 
can no longer type anything). A 
switch on the PC board will 
disable the lock. 


NOTE: AO is part of the core 
constant. If lock-up occurs while 
an undebugged program Is run- 
ning, it is probably printing out 
core constants. 


Hardcopy Toggle. Toggles hard- 
copy switch for task. When 
switch on, all system output 
prints on task HARDEV (or the 
default HARDEV). The hardcopy 
toggle is set to off by system 
command line processor. Tog- 
gling is performed by the input 
device handler and will never be 
put to the task input stream. 
Does not work with FUTIL. 
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SPECIAL Key 
FUNCTION 
CHARACTER AQ 
TABLE 
(Continued) 
AR 
AS 
AT 
AU 
BACK- 
SPACE 
TAB 
LINE FEED 
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i Location 


QCTRL-Q 


CTRL-R 


CTRL-S 


CTRL-T 


CTRL-U 


DEC: upper right 
IOSB: upper left 


DEC: middle left 
(OSB: upper right 


Middle right 


Action 


Restarts a line of input. It rubs 
out all characters typed in back 
to the previous AM. 


If task has terminal: attached, 
AR is ignored. Otherwise, AR is 
followed by a one digit task 
number. If task is not logged in, 
it is logged in and attached to the 
Keyboard. if tnat task is iogged in 
with no COMDEV, it attaches 
the keyboard to the task and 
makes the keyboard its 
COMDEV. 


On a paper tape, 4 S indicates 
an end-of-file. 


Trace Toggle. When the switch 
is on and tracing is in use, trace 
output is sent to COMDEV. 


Noprint Toggle. Toggles 
NOPRINT switch on and off for 
the task. When the switch is on, 
system output prints on the task 
COMDEV (if no COMDEV, the 
task waits to be attached to the 
task using ‘4R; see above). The 
NOPRINT toggle is set by the 
system command line processor. 
Toggling is performed by the in- 
put device handler and does not 
work with FUTIL. 


Same as AH. 


Same as Al. 


Same as A J. 


SPECIAL 
FUNCTION 
CHARACTER 
TABLE 
(Continued) 
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key 


LETTERS 
A-Z 


DELETE 
RUBOUT 


LEAR: 
IOSB: 
INST: 


TTY: 


INFO: 


DEC: 


LEAR: 
IOSB: 
INST: 


TTY: 


INFO: 


DEC: 


LEAR: 
INST: 
IOSB: 


TTY: 


INFO: 


DEC: 


LEAR: 
LEAR: 
lIOSB: 
INST: 


TTY: 


INFO: 


DEC: 


LEAR: 
IOSB: 
INST: 


DEC: 


LEAR: 
IOSB: 
INST: 


DEC: 


LEAR: 
IOSB: 
INST: 


Location 


middle 
middle 
middle 


middle right 
middle right 
middle right 
SHIFT- 

upper right 
middle right 


SHIFT-M 
SHIFT-M 
SHIFT-I 
upper right 
upper right 
SHIFT-) 


SHIFT-N 
SHIFT-N 
SHIFT-6 
upper right 
upper right 
SHIFT- 
middle left 


SHIFT-0 
SHIFT-O 


SHIFT- 


middle right 
SHIFT-DELETE 
upper right 


upper right 
SHIFT-@ 
middle right 
SHIFT-@ 


middle right 
SHIFT- { 
upper right 
SHIFT-] 


Action 


Normally converted to upper- 
case. Lowercase character can 
be typed in when lowercase 
capability is enabled for a task. 
(See LETTERS ‘‘Uppercase’’.) 


When DELETE (or RUBOUT) 
is typed, the system deletes the 
last character typed in and 
echoes \. Typing RUBOUT is 
similar to typing “4H. 


In execute filesA enters control 
characters into the command 
stream. See EXECUTE. 


Sometimes prints as a_back- 
arrow; sometimes prints as an 
underscore. (No special use) 
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SPECIAL 
FUNCTION 
CHARACTER 
TABLE 
(Continued) 


Location 
DEC: SHIFT-\ 
LEAR: SHIFT- \ 
lIOSB: middle right 
INST: SHIFT- \ 
DEC: SHIFT- } 
LEAR: SHIFT-] 
lIOSB: middle right 
INST: SHIFT-ESCAPE 
DEC: SHIFT- 
LEAR: SHIFT- 
lOSB: middle left 
INST: SHIFT- 


Action 
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Card Reader Card reader characters are listed in the table that follows. 
Characters | 
Key Punch 029 026 

Code Character _ Hex Character __ Hex 
12-1 A C1 A C1 

12-2 B C2 B C2 
12-3 C C3 C C3 
12-4 D C4 D C4 
12-5 E C5 E C5 
12-6 F C6 F C6 
12-7 G C7 G C7 

12-8 H C8 H C8 
12-9 | C9 | C9 
11-1 J CA J CA 
11-2 K CB K CB 
11-3 L CC L CC 
11-4 M CD M CD 
11-5 N CE N CE 
11-6 O CF O CF 
11-7 P DO P DO 
11-8 OQ D1 Q D1 

11-9 R D2 R D2 
0-2 S D3 S D3 
0-3 T D4 T D4 
0-4 U D5 U D5 
0-5 V D6 V D6 
0-6 W D7 W D7 
0-7 xX D8 X D8 
0-8 Y D9 Y D9 
0-9 Z DA Z DA 
0 0 BO 0 BO 
1 1 B1 1 B1 

2 2 B2 2 B2 
3 3 B3 3 B3 
4 4 B4 4 B4 
5 5 B5 5 B5 
6 6 B6 6 B6 
7 7 B7 7 B7 
8 8 B8 8 B8 
9 9 B9 9 B9 
11 - AD ~ AD 
0-1 i AF / AF 
12 & A6 + AB 
12-8-2 { FB { FB 

12-8-3 AE AE 
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Card Reader Key Punch | 029 
Characters Code Character __ Hex Character 
(Continued) 
12-8-6 | + AB | < 
12-8-5 (— A8 
11-8-5 ) AY 
11-8-3 $ A4 $ 
11-8-4 - AA . 
11-8-6 ; BB > 
11-8-2 ! Al | 
0-8-3 : AC : 
0-8-6 > BE # 
0-8-7 ? BF % 
8-3 # A3 = 
8-4 @ CO @ 
8-2 ; BA 
8-6 = BD ‘ 
8-5 ‘ A7 1 
none space AO space 
12-8-7 FC 
11-8-7 ~ FE G 
11-9-2 CTRL-R 92 CTRL-R 
11-9-4 CTRL-T 94 CTRL-T 
11-9-3 CTRL-U 95 CTRL-U 
11-7-8 rubout FF } 
12-4-8 < BC } 
0-4-8 % A5 } 
7-8 = A2 } 
12-0 ENQ 85 } 
} 


11-0 CR 8D 
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FILE 
MANAGEMENT 


Filetypes 


Text Files 


File Management 
Catalog 
Structure 


The CGOS 200 GNA hierarchical file system supports sequential and 
random access file types of unlimited size. Each file contains information 
such as drawings, text, keyfiles, source code, executable code, or user- 
developed commands. 


All files in the file manager are assigned a file type according to the follow- 
ing scheme: 


0 Not defined C-E Reserved 

1 Catalog F Z80 Binary files 

2 Object 10-1F Reserved 

3. Text 20-2F Reserved for CADDS 4 
4 Configurations 20 CADDS Parts 
5 Reserved 21 TVF's 

6 PEP object code 22 Figures 

7 Core image (overlay) 30-AF Reserved 

8 Command table BO-BF Reserved 

9 Loader symbol table Batch Processing 
A Reserved CO-FE Reserved 

B Accounting table FF Work Files 


The allowable character set for filenames is A-Z, 0-9, &, #, %, $, @, +, 
— , Lowercase is forced to uppercase. 


All catalogs associated with text files have an ‘“&BCD” level. Each text file 
has &BCD as the next-to-last level of its name. (e.g., Catalog name = 
“Foo”; “Foo .&BCD” contains ‘‘Foo’s” text files.) In referring to a text 
file, the &BCD level of the filename is sometimes omitted. Certain O0/S 
level commands are uniquely associated with text files. When using these 
commands, omit the &BCD. All other commands require that the &BCD 
be specified. | 


Filenames consist of one or more levels. A period is the de/imiter be- 
tween levels. Each level can be up to 20 characters in length; the total 
character count for a filename cannot exceed 80 characters. Any file 
access in command descriptions refers to file manager files. 


Catalogs have a multi-level structure: files that are members of one catalog 


may be subcatalogs with additional files. The main level catalog is called 
SYSCATLG. 
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File Management 
Catalog Structure 
(Continued) 


| MASTER CATALOG (SYSCATLG) | 


ry A es Ered 


y. | \ 
ye | | hy 
y FILE1 | \ 
CATALOGI1 CATALOG2 .. CATALOGn 
j | 
Py E 
we | | \ i 
Fi, FILE1 | NY FILE1 
/ | me 
Sees oe: , SUBCATALOGC 
| 
/ l | 
Zz | SUBCATALOGB 
/ | | 
/ | | 
Filet , File3 
File2 


Sample Filenames 
(Based on the preceding diagram): 
File1 


CATALOG1.SUBCATALOGA.File1 
CATALOG1.SUBCATALOGB.File3 
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To accomodate Graphics Network Architecture (GNA), an additional level 
has been added to the filename. This level designates the node where the 
file is located. The default is the node you are working at. The node level, if 
used, is the highest (leftmost) level. There are now four types of levels in a 
filename. 


EXAMPLE 


[1].*VOLUME.CATLGA.CATLGB.CATLGC. FILENAME 


| 


NODE VOLUME CATALOG FILENAME 
LEVEL LEVEL LEVELS LEVEL 


The above is a complete filename. The file data is located at node 1 in 
the network on the volume with the name VOLUME. 
CATLGA.CATLGB.CATLGC.FILENAME specifies a path on the volume to 
data contained in FILENAME. 


The following conventions are associated with the four types of filename 
levels. 


Purpose 

When systems are networked under GNA, the node level specifies the 
system (node) where file data is located. Only one node level is valid in a 
full name. | 


Format 


[n] where n is an integer of 0-6 inclusive, and the square brackets are part 
of the node level. 


Purpose 
When an auxiliary disc volume is used, the volume level specifies which 


volume of the node file data is located at. Default is primary disc. Only one 
volume level may be used in a full name. 
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VOLUME LEVEL 
(Continued) 


CATALOG 
LEVEL 


FILENAME 
LEVEL 


File Naming 
Restrictions 
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Format 


A character string of at least one but no more than 20 characters (begin- 
ning with an *) that indicates the file manager name. 


Purpose 


These specify a path on the volume to the file data. Multiple catalog levels 
are valid in a full name. 


Format 


A character string of at least one but no more than 20 characters indicating 
the file manager name. 


Purpose 


Specifies entry of the last catalog level in which the file data resides. The 
filename may be a catalog, but it must be the last level in a full name. 


Format 


A character string of at least one but no more than 20 characters Indicating 
the file manager name. 7 


e A full name, including delimiters, may contain no more than 79 
characters. When Working Directories are enabled, any filename 
entered by a user Is joined with the directory entry; although the joined 
name is not generally listed, it is still restricted to 79 characters. 

e Levels between delimiters are limited to 20 characters. 

e The following characters may be used to indicate the file manager name: 


0-9, A-Z, +, —, @, #, $, & % 


Note that [,] and * are special characters used as node and volume level 
identifiers only. 


e Node and volume levels may be omitted from a name. If the node level is 
omitted, the default is the primary drive on the node specified. If both 
are omitted, the default is the primary drive on the local node. 


Disc Volumes 


MULTI-VOLUME 
CONTROL 


SINGLE DISC 
CONTROL 


File and 
Command 
Protection 
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Disc volumes can be utilized under multi-volume control or under single 
disc control. 


The system's primary disc volume ts mounted on physical drive 0. The O/S 
and the previously mentioned Master Catalog are on this primary volume. 
Additional (auxiliary) disc volumes may be mounted in drives 1, 2, and 3. 
The following commands are used with auxiliary disc volumes: 


ENABVOL — incorporates an auxiliary volume’s file structure into the 
Master Catalog on the primary volume. 


DSABVOL — removes an auxiliary volume’s file structure from the 
Master Catalog on the primary volume. 


ATCHVOL — attaches a specific auxiliary disc volume to a task. 


DTCHVOL — detaches an auxiliary disc volume from a task. 


All volumes, except the primary volume, may be physically dismounted 
while the system is running. 


All drives configured on a controller can be initialized (via FMINIT) to be 
treated as one logical disc. Disc packs initialized for ‘‘single’’ disc control 
must be used on the same drives they were initialized on; they are treated 
as one continuous logical disc. | 


Every file and command is designated as a member of a protection group. 
The System Manager assigns Protection Groups to control user access to 
specific commands and files. 


The File Protection Facility is described in the CGOS 200 GNA System 
Manager Guide. 
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Section 3 
SYSTEM COMMANDS 


The CGOS 200 GNA command syntax is very similar to CADDS 4 graphics 
commands. An operator trained on CADDS 4 can similarly use the 100 + 
standard system commands. Standard conventions facilitate the addition 
of new commands. User-developed commands can be standardized for 
One or all system users. 


Although most O/S commands are entered from the command device 
(COMDEV), the system can be directed to take commands from an 
Execute File (activated with the EXECUTE command). The execute file is a 
standard text file that contains system commands. 


This section summarizes CGOS 200 GNA commands. The summaries are 
grouped by function and followed by detailed individual command descrip- 
tions. Some detailed descriptions are omitted from this manual, but 
presented in other CGOS 200 GNA manuals, as follows: 
* Indicates System Manager Guide 
** Indicates Programmer Reference 
*** ~~ Command is described in this manual 


Both the Table of Contents and the Index serve as excellent quick- 
reference sources. On-line documentation will reflect the most recent 
changes to commands described here. 


Brief Command Descriptions 
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BRIEF COMMAND The command descriptions that follow have been placed into categories 
and grouped by functions. 


DESCRIPTIONS 
File Manipulation 


FUTIL O/S LEVEL 


TEXT EDITORS 


OTHER 
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FUTIL is a multi-function file utility. The following FUTIL commands can 
be entered at internal command level (reached by typing: FUTIL )), or at 


O/S level. 


CONVERT*** 


CONVERTB*** 


COPY*** 
COPYTEXT*** 
DELETE*** 
LIST*** 
LISTLP*** 
LISTTEXT*** 
MOVE*** 
PRINT*** 
PRINTLP*** 


CVTECO*** 
EDIT*** 
LONGEDIT*** 


CHGTYP*** 
COMPARE*** 
DUMPFILE*** 
FILCOM*** 
PACHFILE*** 
PRGCOPY*** 


Copies and converts text files to and from magnetic 
tape. 


Copies and converts binary files to and from magnetic 
tape. 


Copies files. 

Copies text files. 

Deletes files. 

Lists file information. 

Lists file information on printer (HARDEV). 
Lists text file information. 

Moves files. 

Prints text files. 

Prints text files on HARDEV. 


Character-oriented text editor. 

Line-oriented text editor. 

Line-oriented text editor that handles line lengths of up 
to 256 characters. 

Changes file type. 

Compares two text files, listing differences. 

Examines file contents. 

Compares two binary files, listing differences. 

Lists and modifies files. 


Modifies a text file by removing identical lines that are in 
sequence. 
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OTHER 
(Continued) 


Batch/Execute 
File Processing 


Command Table 
Commands 


Peripheral Devices 


TASK-RELATED 
FUNCTIONS 


DEVICE CHARAC- 
TERISTICS 


RENAME*** 
SORTCAT*** 
SORTFILE*** 


CANCEL*** 
DO*** 


EXECUTE*** 
GENCOM*** 
PAUSE*** 


PRNTJOB*** 
SUBMIT*** 


EDITCMTB*** 
LISTCMTB*** 
LISTCOM*** 
SYSCMTB* 


USERCMTB*** 


ATTACH*** 
DETACH*** 


DSABDEV* 
ENABDEV* 


RENAMDEV*** 


SETDEV* 


Renames a file or a catalog. 
Sorts catalog entries. 


Sorts a text file. 


Removes a batch or print request. 


Generates a system command to process a text or 
overlay file. 


Processes a text file as a series of O/S level commands. 
Generates an execute file. 


Puts a pause in an execute file where you want the 
system to wait. 


Lists and prints parameters of a job in the batch queue. 


Submits a batch request. 


Edits a command table (CMTB). 
Prints a CMTB. 

Prints active command tables 

Adds a CMTB to the system CMTB. 


Designates a file as user CMTB. 


Attaches a device to a task. 


Detaches a device from a task. 


Disables a device. 
Enables a device. 
Renames a device taskunitname. 


Sets unit characteristic word values for an attached 
unit. 


Brief Command Descriptions 


TAPE DRIVE 


LINE PRINTER 
(HARDEV) 


Disc Commands 


Information 
Commands 


File Manager 
Commands 
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CHECK*** 


DUMPTAPE*** 
GENSLTAP* 
REWIND*** 
SETTAPE*** 
TAPETYPE*** 


SETPUNCH*** 


HARDFILE*** 


FILERCVR*** 
Ljere* 


CHKDISC* 
COPYDISC* 
PACHDISC* 
TEST*** 


DATE*** 
HELP*** 
HELPLP*** 
LCLNEWS*** 
SYSNEWS*** 
STATUS*** 


BOOTDEX* 
FMCHECK*** 
FMCLEAR*** 
FMINIT* 
FMRCVR* 
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Checks magnetic tape files against the original disc 
copies. 


Magnetic tape dump utility. 

Generates a COLDSTART tape. 

Rewinds a tape. 

Changes parity and pack options for tape unit. 


Outputs tape unit information. 


eee Cee woah Se can lk ani am : pont 


Outputs parity information to a puncn paper tape 


device (PPTDEV). 

Sets parity for a punch paper tape device (RPTDEV). 
Declares a file to receive a copy of all system out- 
put to the task. 

Recovers a HARDFILE lost in system crash. 

Sends FORM FEED to HARDEV. 


Verifies a disc pack for use. 
Copies data from one part of disc to another. 
Modifies and/or examines physical disc data. 


Checks system operation and disc access. 


Prints date and time. 

Prints on-line documentation. 

Prints on-line documentation on HARDEV. 
Outputs current administrative and local news. 
Lists information about the O/S. 


Lists system status information. 


Bootstraps Disc Diagnostic Executive (DDEX). 
Checks validity of files under file manager (FM). 
Clears open files under FM. 

Initializes the FM. 


Recovers file manager. 
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Multi-Volume 
Commands 


Programming 
Commands 


Configuration 
Commands 


Communications 
Commands 


PROGRAMMABLE 
COMMUNICATIONS 
UNIT (PCU) 


ATCHVOL*** 
DSABVOL*** 
DTCHVOL*** 
ENABVOL*** 


COMPILE** 
CROSSREF** 


DEBUG** 
FORTXREF** 
GENINDX** 
LISTLOAD** 


LOAD** 
LOADLIB** 
RENUMBER** 
RUN*** 
TRACE** 


BLDSYS* 
COPY CFG* 
EDITCFG* 
LIST CFG* 
NEWCFG* 


COMPPCU*** 


LOADPCU*** 
PCUPCH*** 


Attaches an auxiliary disc volume to a task. 
Disables auxiliary volume. 
Detaches auxiliary volume from a task. 


Enables auxiliary volume. 


Compiles a TPL or FORTRAN source file. 


Lists entry points and external references for object 
files. 


Allows you to monitor and change program execution. 
FORTRAN cross-reference utility. 
Outputs specified index from program source files. 


Searches a text file for file references, then outputs a 
list. 


Creates a core image file. 

Creates a load library. 

Renumbers a FORTRAN text file. 

Reads an overlay into core and executes. 


Traces subroutine calls in an executing program. 


Builds on O/S under a new configuration (CFG). 
Copies a configuration (CFG). 

Edits a configuration (CFG). 

Lists a configuration (CFG). 


Creates a new configuration (CFG). 


Compares contents of PCU memory to a PCU 
overlay file in hexload memory. 


Transfers a file to PCU for (optional) execution. 


Patches PCU overlay files. 
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GRAPHICS GETSLIB*** Maintains current subfigure library at a GNA 
NETWORKING satellite node. 
ao NETDIAG*** Exercises a point-to-point network link for diagnosis. 
NETSTATS*** Outputs timing statistics for a link in a GNA configura- 
tion. 
NETTEST*** Exercises network links in a configuration. 
SYSSIZE*** Checks whether sufficient memory is available for a net- 
work task. 
Protection Facility AUTHRIZ* Verifies entries and encodes passwords for Login 
Commands | authorization file. 
CHGPROT*** Changes a file’s protection group. 
EDITACT*** Creates, modifies, or deletes access tables. 
LISTPROT*** Lists your access table and default protection group 
(DPG). 
SETPROT*** Changes your DPG. 
Memory DUMP*** Dumps memory. 
Processing SET*** Sets memory locations. 
Commands 
Working Directory DSABDIR*** Disables the current working directory. 
Commands ENABDIR*** __ Enables the specified working directory. 
LISTDIR*** Lists the current working directory. 
Miscellaneous 
Commands 
HEX CONVERSION FPHEX*** Converts floating point to hexadecimal. 
HEXCALC*** Performs arithmetic operations on hexadecimal 
numbers. 
HEXFP*** Translates hexadecimal to floating point. 
TASK FUNCTIONS LOGOUT*** Terminates a task. 
SELECT*** Sets task parameters. 
ERROR DUMPERR*** _ Prints system error information. 
HANDLING ERRLOG* Outputs a formatted dump of the system error log. 
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UTILITY 
COMMANDS 


Abbreviating 
System 
Commands 
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ARCHSRCH*** Looks up records in a Data File created with ARCHINDX. 
GENFICHE*** Converts text files to microfiche format on tape. 
HEADER*** Outputs a two page heading. 
lIOTEST*** Tests system |/O handlers. 
OPLOG* Processes the operation’s log table. 


SRCHBCD*** — Locates strings in text file(s). 

e Review the EDITCMTB command (See EDITCMTB command.) 
e Type LISTCOM Verifies that command exists. 
Example 

(Abbreviate ATTACH command to AT) 


n>EDITCMTB SYSCMTB } System gives prompt. 


#l Enter responses to queries as follows: 
Query Response Remarks 
NAME: AT Desired abbreviation. 
DLOC: FFFF Special response, denotes cross-reference 
entry. 
XNAM: ATTACH Maximum of 8 Characters. 
STRT: 0000 Relative start location (Max. 4 Characters). 


Queries repeat to allow several abbrevia- 
tions to be entered in one session. 


NAME: ) Ends Query cycle. 
#T Checks for accuracy and completeness. 
# F Files changes. 
e Type LISTCOM Verifies that abbreviation(s) are incor- 


porated in the SYSCMTB. 
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SAMPLE PRINTOUT n»n>LISTCOM } 
FOR ABBREVIATING COMMANDS THAT CAN BE EXECUTED FOR THIS TASK 
COMMANDS _ | 


AEDIT ASSM ATCHVOL ATTACH 
BYE C CADDS CATLIST 
CHGTYP CHDISC CL COLORS 
CONVERT4 CONVERTB COPY COPYCFG 


n>EDITCMTB SYSCMTB ) 
#| 


NAME: 
AT 


| a ee I 


DLOC: © 
FFFF 
XNAM: 
ATTACH 
STRT: 
0000 
NAME: 


} 
#7 


1! AT ATTACH + 0000 


2! C CADDS + 0000 
3! FPHEX HEXFP + 0002 


#F 
n>LISTCOM ) 


COMMANDS THAT CAN BE EXECUTED FOR THIS TASK 


AEDIT ASSM AT ATCHVOL ATTACH AUTHRIZ 
BOOTDDEX BYE C CADDS CATLIST = CATSCAN 
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AUTHRIZ 

CATSCAN 
COMPARE 
COPYDISC 


BATPROC 
CHECK 
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The current verb-noun combinations of a CADDS command may need to 
be changed if: 


Renaming 

CADDS 4 

Level Commands | 
¢ Commands must be translated into another language. 
e A more specialized command description is needed. 
¢ Command availability must be limited. 


SAMPLE n>EDIT DATA.VNP ) 

PRINTOUT #L, DELETE 
39! *DELETE DES 21 66 0000 
40! *DELETE DMR 2020 4 0000 
41! *DELETE GROUP 21 15 0000 
42! *DELETE NFLAG 2029 7 0000 
266! DELETE CPLANE 178 3 O07E 
267! DELETE DRAWING 181 2 007C 
268! DELETE ELEMENT 5026 1 C074 
269! DELETE ENTITY 21 3 C074 
270! DELETE EPROPERTY 5026 3 C074 
271! DELETE FACE 5025 1 4074 
272! DELETE GPOINT 5026 2 C074 
273! DELETE HOLE 5029 2 4074 
274! DELETE IMAGE 180 4 007C 
275! DELETE LOAD 5026 5 C074 
276! DELETE PART 534 O07E 
277! DELETE PPROPERTY 2024 6 807C OLD ERS PPROP 
278! DELETE PROPERTY 2024 2 807C OLD ERS PROP 
279! DELETE SET 1061 5 0074 
E276 
DELETE PART 53 007F 
REMOVE 
REMOVE PART 53 4 007F 
#F 


n> DELETE DATA.VNP//LIST = LONG } 
DATA.VNP DELETED 
DATA 
NOT DELETED; CATALOG NOT EMPTY 
n>CADDS } 
CADDS 4 REV # 2-00-A 1-20-81 15:45:33 
SORTING VERB-NOUN TABLES 
START SORT 
END SORT 
COMPILING VERB-NOUN TABLES 


The compilation was successful. 
Input device is SD. 

DATA.VNP is filed. 

Hf 


ARCHSRCH 


ARCHSRCH 


PURPOSE 


SYNTAX 


COMMENTS 


Locating Records 
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Looks up records in an archive index. The system administrator maintains 
the archive index and adds records when files are saved on tape or moved 
using GNA. 


ARCHSRCH [filename] } 
#¢Command ) 


filename (Name of an archive index. (There is usually only one for the 
system.) 


Command LOCATE or QUIT 


ARCHSRCH uses two types of files to retrieve information about files in 
the archive: 


e The primary archive index file, f/ename, (created and maintained with 
ARCHINDX — see CGOS 200 GNA System Manager Guide) where 
all information is stored. This information can include the storage 
location, file type, filename, and the date each file was archived. 


e Several Key Files for looking up records. There can be a Key File for 
each field in the primary archive index file. The actual number of Key 
Files is determined when the archive is set up. 


Whenever files are backed up on tape or otherwise saved, the FUTIL 
archive option can be used to generate information for the archive index. 
To find file information records stored in the archive index, use the 
command: 


LOCATE [filename] [/OPTIONS] 


filename — Full filename in standard filename format, or to locate all files 
with common characters or catalog levels, use WILD CARDS 
or the MATCH option. | 


OPTIONS One or more comma-separated entries in the following format: 
Option = Contents of key field 


DATE Date, and optionally time, of the archiving (e.g., 
DATE = 2-28-81 or DATE = 2-28-81:14:00:00). To find a 
record, the date, and time if given, must be an exact 
match. For less precise matching of dates, use BEFORE 
or SINCE. 


ARCHSRCH 
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Locating Records BEFORE Locates files archived before date, and optionally, time 
(Continued) (same format as DATE). 
SINCE Locates files archived after date, and optionally, time 


(same format as DATE). BEFORE and SINCE may be 
combined to specify a range of dates. 


TYPE File manager file type — hex number between 0 and FF 
(e.g., TYPE=3 (Text), TYPE=1 (Catalog)). 


LOCATION Storage location of archived file: Disc pack, Node 
name, or Tape label (e.g., LOCATION =TAPE.01, 
LOCATION = [0].* PACK033). 


COMMENT Matches a comment of up to 80 characters supplied 
when the record was added to the archive index. 


MATCH Allows you to substitute for 0-n characters after one or 
more characters of the filename has been entered. 


Wild Cards Three characters allow you to substitute for any CARDS character or 
catalog level in the filename. With these characters, all files matching the 
rest of the filename will be located. 


Wildcard Description 


? Substitutes for a single alphanumeric character in a 
filename. With two or more ?’s, two or more characters 
in the same positions will produce a match. A ? cannot 
replace the dot (.) used as a catalog level name 
separator. 


?\ Like ? but substitues 0 to n characters within a catalog 
level. 


| Substitutes for a full catalog level in the filename. The 
catalog level must contain one or more characters. 
When using more than one (!), separate catalog from 
non-wildcard levels by the usual dot (.). 


Substitutes 0 to n full catalog levels. 
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EXAMPLES Specification Possible Filenames 


CAT?EVEL CATLEVEL 
CAT-EVEL 
CAT6EVEL 


FIL??AME FILENAME 
FILS6AME 
FIL-2AME 


FILE? \ FILE 
FILE1 
FILE123-0 
?\ LENA? \ LENA 
| FILENAME 
CATALENA 


CAT.!.G CAT.CAT1.G 
CAT.A.G_ 
CAT.&BCD.G 


CAT.!.G CAT.A.B.G 
CAT.Q.&BCD.G 


CAT.!\.G CAT.G 
CAT.&BCD.G 
CAT.A.B.C:D.G 


CAT.? \ .FILE CAT.FILE 
CAT.&BCD.FILE 
CAT.A.FILE 


CAT.!.?\ .FILE CAT.X.FILE 
CAT.X.&BCD.FILE 
CAT.Q.A.FILE 


CAT.! \ .?\ .FILE CAT.FILE 
CAT.A.FILE 
CAT.&BCD.FILE 
CAT.A.&BCD.FILE 
CAT.A.B.C.FILE 


NOTE Each KEY field entered as a LOCATE option will speed record lookup. 


To execute a search with Wild Cards in the filename, or non-key fields 
alone, each record must be searched in sequence. In general, this is a time- 
consuming procedure. LOCATE } lists the entire contents of the archive 
index. 
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SYNTAX 
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ARCHSRCH uses two characters to prompt for input: 


# is the general prompt. 
* prompts for a specific response to a question. 


Any command or keyword may be issued in abbreviated form. 
ARCHSRCH needs only enough of the command name to make it unique 
(e.g., Q, QU, or QUIT are all acceptable input for the QUIT command). 


When ARCHSRCH asks for an OK response, Y, YE, YES, or OK are suffi- 
cient affirmative answers. N or NO will suffice for a negative response. 
With critical questions, any other response will cause the prompt to be 
retyped. 


At the end of the session, type QUIT to return to O/S level. 


Break up multi-line commands using a semicolon (;) between syntax 
elements. A semicolon can also be used to break up the comment field. 


Example 


#LOC TEST.FILE/TYPE = 2,B =2-5-81,5 = 2-5-80; } 
> ,LOC=TAPE1 


When ARCHSRCH detects a syntax error caused by a typing mistake, it 
retypes the line segment preceding the error. The segment accepted and 
retyped with an angle-bracket(>) cannot be erased or typed over. Con- 
tinuing the line with ) aborts the command. Any other response, in- 
cluding a space, is assumed to be a correction and continuation. 


Example 
#LOC TEST.FILE/TYPE=2,B = 02-5-81, AFTER = 02-5-80 ) 


-- NO SUCH FIELD IN THE RECORD 
> LOC TEST.FILE/TYPE=2,B =02-5-81 


ATCHVOL 


ATCHVOL 
PURPOSE 
SYNTAX 


COMMENTS 


MESSAGES 


ATTACH 


PURPOSE 


SYNTAX 
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Attaches specific auxiliary disc volume to a task. 
ATCHVOL volume name 


ATCHVOL associates the volume with the task that calls it. (The volume 
must have been previously enabled; see ENABVOL.) While attached, the 
volume may not be disabled or removed from the drive. | 


VOLUME NAME ON DRIVE <LOGICAL Indicates that the volume is success- 
DRIVE NUMBER> ATTACHED TO TASK fully attached. 


< TASK NUMBER> 


Example 
n> ATCHVOL *OS } Enter command. 
* OS ATTACHED TO TASK n System response. 


Attaches a device to a task. After message is printed, control automatically 
returns to the system. 


ATTACH Taskunitname, Unittype or Uniqname. 
Taskunitname — arbitrary two-character unit name (user-assigned). 


Unittype — Generic four-character name (see list). When Unittype is 
specified, ATTACH uses first available unit. 


Uniqname — Particular unit of Unittype. Designated by generic name’s 
first three letters plus a digit specifying Unittype’s unique unit. 


Unittypes 
TTYS Teletype 
INFO Infoton 


LPTR Standard Line Printer 
TRMN Terminet 1200 

(not Terminet 340 Line Printer) 
lOSB lOS Board 


SYNTAX 
(Continued) 


MESSAGES 


ATTACH 
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NMDX Numeridex 

DTMX Versatec 

DCMN Card Reader 

XYNT Xynetics Plotter 

FPTR Fast Paper Tape Reader 

FPTP Fast Paper Tape Punch 

DTMX Varian 216 

DTMX Varian 208 

TBIO Task based I/O Skeleton Unit 

GOUL Gould 5100 Dot Matrix Printer/Plotter 
GOUL Gould 4800 Dot Matrix Printer/Plotter 
VGUB Video Generation Unit 

GPUB Graphics Processing Unit 


PCUC PCU Control Port 
PCUG PCU General Port 


Uniqname OF TYPE Unittype ATTACHED 
AS Taskunitname 


NO UNITS OF TYPE Unittype AVAILABLE 


Uniquename ATTACHED TO TASK 
Tasknumber 


Uniqname NOT AVAILABLE 


BAD REQUEST 


Example 


To attach a magnetic tape drive: 


n> ATTACH MT,TAPE ) 


TAPO OF TYPE TAPE ATTACHED AS MT 


Or 


NO UNITS OF TYPE AVAILABLE 
TAPO IS ATTACHED TO TASK 4. 


Successful attach. 


No units of requested type are 
available. 


Type Unittype in the configuration 
but attached to a task. (Output for all 
devices of type Unittype.) 


Uniqname used/Uniqname_ device 
already attached to a task. 


Taskunitname already assigned to 
another unit, or Unittype is bad. 


Enter command. 


System response if TAPO is the first 
available magnetic tape drive. 


Tape drive is being used by task 4. 
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CANCEL 


CANCEL 
PURPOSE 


SYNTAX 


CHECK 
PURPOSE 
SYNTAX 


COMMENT 
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Removes BATCH/PRINT request from job queue. 


CANCEL JOB = Jobname. 
CANCEL PRINT = Jobname (20 characters or less). 


Checks magnetic tape files against the original disc copies. 
CHECK[/Options] Catalog[/Options] 
CHECK is a FUTIL subcommand as well as an O/S level command. The 


FUTIL section contains additional documentation. (See the FUTIL Over- 
view or the Index under FUTIL CHECK.) 
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CHGPROT 
PURPOSE Changes protection group of a file or catalog. 
SYNTAX CHGPROT filename,PG al,PG b] 


Any combination RWEDCM or S, G, or P. Filename may be a full filename 
or a Catalog name. 


PG = (Protection group); a and b are Hex numbers in the range 
0000 - 7FFF. 


S,G,P = Default designators (System, Group, Private). 


RWEDCM = Attributes of PG range: Read, Write, Execute, Delete, 
Change, Modify. 


COMMENTS CHGPROT changes your file access by changing the file’s PG. CHANGE 
access required to file/catalog’s PG; access to new PG required. 


To Specify Protection Group 


1. State PG as HEX number. If Filename is full name of file, file is given a PG 
of a. If Filename is a catalog name and only PG a is specified, all catalog 
levels from Filename down and all files in any of these catalogs will be 
given a PG of a. If PG 5 is also specified, catalog are given PG b; catalog 
files are given PG a. 


2. Use default designator with requested combination of attributes. 
Because a PG is implied by the default designator (S,G,P), the actual PG 
does not need to be known. This number will be the first PG listed in the 
current user’s access table with the exact combination of attributes input 
through CHGPROT. In this mode, catalogs and files cannot be given dif- 
ferent PGs. 


MESSAGES 7 Any file management errors (including protection violations) are output 
with the Filename associated with the error. | 


Current Access Table 


2000-2000/WRDCS 
2500-2500/RP 
2400-2400/RECG 
2700-2700/WRDC 
2800-2900/REWD 
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Example (Protection of FILEA = 2400) 


n> CHGPROT FILEA,SWRDC ) 


n> CHGPROT FILEA,GRECWD ) 


n> CHGPROT FILEA,2850 ) 


OK 


n> CHGPROT FILEA, PREX ) 


n> CHGPROT FILEB,2500 ) 


n> CHGPROT FILEC,22400 ) 


Changes PG of FILEA to 2000. 
Yields message: 


NO PROTECTION GROUP FOUND THAT MATCHES 
ATTRIBUTES SPECIFIED. 


(Because there is no PG range in 
vour access table 


and attributes 


designator ‘G’ 
‘RECWD’.) 


Produces the warning: 


YOU DO NOT HAVE CHANGE ACCESS TO THE NEW 
FILE PROTECTION GROUP SPECIFIED TYPE OK TO 
CHANGE ANYWAY. 


Change FILEA’s PG to 2850; you are 
unable to make further PG changes 
to file. 


Produces the message: 
INVALID PROTECTION ATTRIBUTES SPECIFIED 
(‘X' is not a valid attribute.) 


lf FILEB has a PG of 3000, the result- 
ant message is: 


YOU HAVE NO ACCESS PRIVILEGES TO THE NEW 
FILE PROTECTION GROUP SPECIFIED 


FILEB’s protection is unchanged. 


If FILEC is PG 2800, the protection is 
changed to 22400 and task is returned 
to system level. 


CHGTYP 
PURPOSE 


SYNTAX 


CHGTYP 


The information and drawings contained herein are the sole property of Computervision 
Corporation. Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 


express written consent of Computervision. 


Changes a file manager file type. 


CHGTYP filename, file type 


Where file type is an integer between 0 and OFF (hex). (Leading zeros must 
be used when the file type begins with an alpha character.) File manager 


file types are as follows: 


Not defined 

Catalog 

Object 

Text 

Configurations 
Reserved 

PEP object code 
Core image (overlay) 
Command table 
Loader symbol table 
Reserved 
Accounting table 


DPpPoOomrIMH 8H hRWN-o 


Example 


n> CHGTYP &BCD.FILE,0A } 


FILE TYPE CHANGED 


Filetypes 


C-E Reserved 
F Z80 Binary files 

10-1F Reserved 
20-2F Reserved for CADDS 4 

20 CADDS Parts 

21 TVF’s 

22 Figures 
30-AF Reserved 
BO-BF Reserved for 

Batch Processing 

CO-FE Reserved 

FF Work Files 


Changes Type 3 (&BCD.FILE) to a 
Type OA file. 


System response. 
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PURPOSE 
SYNTAX 


Standard Format 


OUTPUT 
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Compares two text files and lists differences. 
COMPARE [cat1.file1{,cat2.file2 /NEWCAT = mycat}] 


COMPARE accepts various filename and option specifications. The most 
basic syntax is useful for en two files with dissimilar (short) 
filenames: 


n> COMPARE cat1.file1,cat2.file2 ) 
This will compare Cat1.&BCD.file1 to Cat2.&BCD.file2 
NEWCAT(N) 


Often, you may want to compare your version of a file to a version in the 
SYSCATLG. NEWCAT (abbreviation N) facilitates this sort of comparison 
by requiring that only one filename be entered. COMPARE forms the 
second filename by adding a catalog level prefix to the first filename (i.e., 
SYSNEWS.COMMAND.HEADER becomes JOQC.SYSNEWS.COM- 
MAND.HEADER). This prefix is entered on the command line instead of a 
second filename. NEWCAT syntax: 


COMPARE cat.file/ NEWCAT = mycat 


Compares the original version (cat.file) to the mycat version, as if you had 
entered the command: 


COMPARE cat.file, mycat.cat.file 


The default for mycat is your Login username. If you login under 
MYNAME and type COMPARE cat.file/N, the following command is 
generated: 


COMPARE cat.file, myname.cat.file 


Each comparison is made on a line-by-line basis. Any differences are out- 
put. If no differences are found, a message to this effect is output. For 
each difference found, COMPARE outputs a line group from 
cat1.&BCD.file1 (referred to as ‘A’ below), and a line from 
cat2.&BCD.file2 (referred to as ‘B’ below). In each case, an attempt is 
made to output the line preceding the differences (the same for both files), 
and the line following the differences (the same for both files). Next to 
each line number is one of the following keys: 


=): Lines the same in both files 
(A): Lines in file (A) different from (B) 
(B): Lines in file (B) different from (A) 
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Typical COMPARE 
Printout 


Dialogue Format 


NOTE 


> COMPARE R5.SYSNEWS.COMMAND.DUMPKERN, SYSNEWS. 
COMMAND.DUMPKERN ) 


(A)  12-7-81 9:13:49 
R5.SYSNEWS.COMMAND.DUMPKERN 
BEING COMPARED WITH 


(B) 10-23-81 1:06:02 
SYSNEWS.COMMAND.DUMPKERN 
FILE DIFFERENCE FOUND: 


CJCVCICICI EVOLVE CIEE CIC EV CI CPCI CIC ECCI 
17( =)! 

18(A)! FOLLOWED BY THE ASCII REPRESENTATION FOR EACH BYTE 

19(A)! (NON-DISPLAYABLE CHARACTERS ARE OUTPUT AS PERIODS). 

20( =)! FOUR DOTS(....) REPRESENT THE CORE CONSTANT (OCOF). 


6 f @ ¢ € © #& © 8 © © F 8 F F Ff 6 #8 &§ &€ &€ 8 & 6 #8 86 & © &# 8 F &F FF F & F FF F oo fF #6 ££ 6© © © © 4 F 


17( =)! 
18( =)! FOUR DOTS(....) REPRESENT THE CORE CONSTANT (OCOF). 
CYCICILICICIEIEI CIC CIC CVC CCIE CII OCLC od0d 


CICICICICUCIEI ECPI CIT ICV CIC CPCI TI CPOE 
26( =)! COMPLETION OF THE DUMP. 

27(A)! 

30(A)! DUMPKERN 0-0F 

31(A)! 

32(A)! 0000 7809 4907 0501 7A9F OD63 0000 14D4 0000 ....T 

33(A)! 0008 1516 7C05 0007 0000 711E 7833 7808 78A9 ....) 


6 © &§ @ 0 &# 6 8B F 8 &F 8 8 &F 8 & 8 8 & & 6 & & F 6 F &F 8 F F & F &F © F&F FF F & F & F&F © & FF Fb 


24( =)! COMPLETION OF THE DUMP. 
CYCVCICICICIEIP CIEE CICVOV CIC CI CITI CIO EIGN 


END OF COMPARE 


COMPARE will also prompt for filenames and options. To initiate this type 
of dialogue, type COMPARE ). COMPARE outputs the following series of 
prompts (possible user responses in lower case): 


n> COMPARE ) 


PLEASE TYPE TWO FILENAMES 


Cat1.File1, Cat2.File2 ) 


SHOULD BLANKS BE IGNORED?(YES,NO) 


YES ) | 
SHOULD COMPARE BE SYNCHRONIZED?(YES,NO) 


YES ) 
The Dialogue Format has several advantages: 


e Additional flexibility in specifying filenames — in response to the 
ENTER TWO FILENAMES prompt, COMPARE supports filename 
syntax types described under Standard Format. The Dialogue Format 
also allows you to use one line for each filename, as follows: 


PLEASE TYPE TWO FILENAMES 
cat1.subcat1.file1, ) 
cat2.subcatz2.file2 


Each name may be up to 80 characters long (including the comma 
separator, which must precede the })). 
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Standard Compare 
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e Normally, COMPARE outputs differences in spacing literally. As an 
alternative, the Dialogue Format allows you to ignore spacing 
between characters. If characters on two lines are identical, COM- 
PARE treats the lines as identical, regardless of between-character 
spacing. 


¢ Synchronized comparisons are allowed. If you answer YES to sHouLp 
COMPARE BE SYNCHRONIZED2(YES,NO), COMPARE looks ahead for similar 
lines. If lines are identical, but less than five characters long, COM- 
PARE will only find a match if the following line in each file is also 
identical. 


Example 


Comparing the following files with standard and synchronized methods 
results in two different outcomes: 


File 1 File2 
11XXXX 11XXXX 

2\* 2\* 

31+ 3!BBBB 

41BBBB 4\* 

5! 5IMORETHANSCHARACTERS 
6!* 


7!MORE THAN 5 CHARACTERS 


n> COMPARE CAT1.FILE1,CAT1.FILE2 } 


FILE DIFFERENCE FOUND: 
PIPE eee ey Pee Cpe 


2( =)!" 
3( =)!" 

a =)I" eof © fF F Ff | A A es ee ee A Ae ee U a oF F&F F F&F FF F Hh SF | rn ay (ns Mee ee! es Ae Se 
3(B)!BBBB 

4( =)|* 
saa oa eee ea ee ae 
ClerGOlGrale Cher GNai ela GhOlere lela rclatanenoOlmialarahene 
3( =)!" 

4(A)|BBBB 

B(A)!* 

6(A)!* 


7(A)!IMORE THAN 5 CHARACTERS 


, ¢ Ft FF FF F&F 86 F F Ff , ‘ c , , ‘ , , , , Uy ‘ , ‘ ‘ oe of # #& © FF F FF OF 8 & tt fF #F F FF FF FF F , é Uy 


5(B)!MORETHANSCHARACTERS 
is dF 0 2 Oa i ee PO Ul WG 


END OF COMPARE 


Synchronized 
Compare 


COMPILE 
PURPOSE 
SYNTAX 


NOTE 
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n> COMPARE ) 


PLEASE TYPE TWO FILENAMES 


Cat1.File1, Cat1.File2 
SHOULD BLANKS BE IGNORED?(YES,NO) 


YES ) 
SHOULD COMPARE BE SYNCHRONIZED?(YES,NO) 


YES ) 


FILE DIFFERENCE FOUND: 
PYCVEPEVCI CECE EPEC CITE OI CITI EI OIE 


2(=)!* 

3(A)!* 

4(=)!BBBB 

5( = )!* 

2( = )!* 

3(=)!BBBB 

4(=)!* 
CYEVCIEICPEICPOCVCP CIEE CP EI CUETO ECO 
o( = )!* 

6(A)!* 


7(=)IMORE THAN 5 CHARACTERS 


4(=)!* 
5( = )!MORETHANSCHARACTERS 
END OF COMPARE 


Compiles a TPL or FORTRAN source file. 
COMPILE filename [/options] 


See CGOS 200 GNA Programmer Reference Manual for additional infor- 
mation. 
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CONVERT 


CONVERT 


PURPOSE 


SYNTAX 


COMMENTS 


CONVERTB 


PURPOSE 


SYNTAX 


COMMENT 
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Copies and converts special format magnetic tape files. 


CONVERTI/Options] 
[CatalogI[/[Filenamelist] [/Options]]] 
[Catalog[//Options]] 


e The tapes converted are generally fixed-block, fixed-record tapes. This 
command converts text files only. 


e Additionally, CONVERT reads or punches paper tape, and reads cards. 
It provides character set and conversions for several industry standard 
character sets. 


e CONVERT is a FUTIL subcommand as well as an O/S level command. 
The FUTIL section contains additional documentation. (See the FUTIL 
Overview or the Index under FUTIL CONVERT.) 


Identical to CONVERT except that it does only binary file conversions. All 
files are copied as binary files without any character set conversions. 


CONVERTBI/Options] 
[CatalogI/[Filenamelist] [/Options]]] 
[Catalog[//Options]] 


CONVERTB is a FUTIL subcommand as well as an O/S level command. 
The FUTIL section contains additional documentation. (See the FUTIL 
Overview or the Index under FUTIL CONVERTB.) 
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COPY 
PURPOSE Copies files from one device or catalog to another. 


SYNTAX COPY|[/Options] 
| [Catalog[/[Filenamelist][/Options]]] 
[Catalog[//Options]] 


Example 
Copies all files in CAT1 with names ending in FILE1 to CAT3: 
n> COPY CAT1/&BCD.FILE1,FILE1 CATS ) 


CAT1.SUBCAT1.&BCD.FILE1 
COPIED TO 
CAT3.SUBCAT1.&BCD.FILE1 


CAT1.SUBCAT1.FILE1 
COPIED TO 
CAT3.SUBCAT1.FILE1 
COMMENTS COPY is a FUTIL subcommand as well as an O/S level command. The 
FUTIL section contains additional documentation. (See the FUTIL Over- 
view or the Index under FUTIL COPY.) 
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COPYTEXT 
PURPOSE | Copies text files from one device or catalog to another. 
SYNTAX COPYTEXT[/Options] 
| [Catalog[/[Filenamelist] [/Options]]] 
[Catalog[//Options]] | 
Example 
Copies all text files in CAT1.SUBCATZ to CAT3.SUBCATZ2: 
n> COPYTEXT CAT1.&SUBCAT2 CAT3.SUBCAT2 ) 
CAT1.&BCD.SUBCAT2 
COPIED TO 
CAT3.&BCD.SUBCAT2 
CAT1.SUBCAT2.&BCD.FILE 
COPIED TO 
CAT3.SUBCAT2.&BCD.FILE 
COMMENTS COPYTEXT is a FUTIL subcommand as well as an O/S level command. 
The FUTIL section contains additional documentation. (See the FUTIL 
Overview or the Index under FUTIL, COPYTEXT.) 
CROSSREF 
PURPOSE Lists entry points and external references of object files. 
SYNTAX CROSSREF 
NOTE | See CGOS 200 GNA Programmer Reference Manual for additional infor- 


‘mation. 
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CVTECO 

PURPOSE Edits text files. CVTECO is a powerful character-oriented editor that uses a 
one-page buffer and a pointer to create and modify text files. 

SYNTAX CVTECO [filename] 

[/MACRO = file1, MACRO = file2,... MACRO = filen] 

COMMENT In processing the command line, the system sets up and executes the first 
CVTECO command. 

INPUT/OUTPUT n> CVTECO ) This command line enters CVTECO and executes 


the command $8. 


TECO Version 5.00 Appears on COMDEV; indicates that you have 
entered CVTECO. 


ff The system is waiting for a CVTECO command. 
OPTIONS 


filename A filename input as part of the command line will set up 
and execute one of these CVTECO commands before the 
# prompt is displayed: 


Command Line Corresponding CVTECO Command 


1. CVTECO oldfile 1 EBoldfilesEAS$$ 
2. CVTECO newfile 2. EWnewfile$s 


MACRO = oldfile 


CVTECO executes the existing text file, oldfile, as a series 
of CVTECO commands (CVTECO MACRO). Each 
MACRO file is executed in the order specified in the 
command line. The CVTECO prompt (#) appears after the 
entire MACRO, or series of MACROs, has been executed. 
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Modifying/Creating 
Text Files 


CVTECO Pointer 
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Command Line Corresponding CVTECO Command 
1. CVTECO oldfile/ 1. ERfilelS2EAERfile2$ 
MACRO = file1, 2EAHXMHKEBoldfilesEAMMS$$ 
MACRO = file2 | 
2. CVTECO newfile/ 2. ERfile1$ 
MACRO = file’ 2EAHXMHKEWnewfilesMMS$$ 
3. CVTECO/ 3. ERfilelS2EAHXMHKMM8$§ 
MACRO = file1 


If there is a text file named .CVTECO in the catalog user- 
name.&BCD, that file will be executed as a MACRO each 
time you (as task username) enter CVTECO. This is done 
by default and need not be specified in the CVTECO 
command line. 


CVTECO has input and output text files, and a buffer. CVTECO reads 
one page from the input file into the buffer, modifies the buffer page, 
and writes the page into the output file. By repeating this cycle, the out- 
put file becomes a modified version of the input file. 


CVTECO uses a similar process to create new text files. There is no input 
file, the output file and the buffer are empty. Text is inserted into the 
empty buffer. When the buffer is full, its contents are written to the out- 
put file. This process is executed repeatedly to create the output file. 


The CVTECO pointer indicates a position in the buffer. CVTECO 
commands are initiated at the pointer position. 


The pointer is always positioned between two characters (except before 
a page’s first character and after the page’s last character). Characters 
can be deleted on either side of the pointer, and can be inserted at the 
pointer. Following an insertion, the pointer is positioned immediately 
after the last inserted character. 


The pointer can be moved backward and forward in either of two ways: 


1. Specify position numerically (e.g., position pointer immediately 
after 25th character of third line; or, move pointer forward 6 
characters). 


2. Locate pointer position. Located by searching for an occurrence 
of specific text string (e.g., position pointer after first occurrence 
of ‘dul’ in ‘Jack was a dull boy’). Search command starts searching 

at pointer position and moves to end of page. 


Command 
Modifications 


. Special Characters 


CVTECO 
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e Many commands can accept up to two numbers as arguments. 
Numbers precede the command letter. Two numbers must be separated 
by a comma (e.g., “5V", ““4,6T’’). 


e Some commands return as values numbers which may be used as 
arguments to other commands (e.g., ““H”, “Z’’, “’.”"). 


e Some commands accept one or two text strings as arguments. A text 
string follows the command letter and is terminated by the ESCAPE 
character, which echoes on the terminal as a $ (e.g., “‘Istring$’”’, 
“Rstg1$stg2$"’). 


® @ modifies any command requiring a text string argument. @ precedes 
the command letter. When it is used, the text string is not terminated by 
ESC. The delimiter character for the text string(s) follows the command 
letter (e.g., “@l/string/"’, “‘@R \ stg1 \ stg2\”’). 


e Some commands can be modified with a colon (:). Prefix the colon to 
the command letter. 


e The N-register (numeric register) is an argument to some commands. 
Thirty-six N-registers are available; each one has a single-character 
name, either a digit (0-9), or a letter (A-Z). Twenty-six system 
N-registers have reserved uses. Each has two-character name, a dot (.) 
followed by a letter (A-Z). The N-register name follows the command 
letter (e.g., ““Q1", “%A", “72P.W"’). 


e The T-register (text register) is an argument to some commands. Thirty- 
six T-registers are available to each user. Each T-register has a single- 
character name, either a digit (0-9) or a letter (A-Z). The T-register name 
follows the command letter (e.g., ““X1", GA”). 


The following characters have special meanings in relation to all CVTECO 
commands. They are used as command delimiters, or to facilitate typing of 


commands. 

<BS> Backspace erases last character typed. 

AQ Erases entire command. 

AR | Retypes entire command. 

AX Erases entire command being typed. 

AZ Quotes next character; permits special charac- 


ters to be entered as part of a command string. 
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Special Characters <ESC> | 
(Continued) 


<ESC> <ESC> 
<RUB> 


CVTECO COMMANDS 


GROUPED BY 
FUNCTION 
Character Manipula- AC 
tion Commands AS 
n: AS 
AT 
“AT 
Commands that AC 
Return a Value AT 
AT 
# 
% 
0123456789 
A 
“F 
H 
Q 
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Terminates a text string; echoes as a dollar sign 
($). 


Terminates a command string. 


Rubs out (deletes or erases) last character typed. 


CVTECO commands are main single characters. 
An “E”, up-arrow ("‘ A“’) or right square bracket 
(“{’') modifier is always the first character in 
commands of two or more characters. 


Converts characters to integer values. 


Converts integer into character; inserts result in 
buffer. 

Converts n to a character; prints it on the 
COMDEV. 


Reads a character from the COMDEV; converts 
it into integer. 


Reads a character from the buffer; converts it 
into integer. 
Converts characters to integer values. 


Reads a character from the COMDEV; converts 
it to integer. 


Reads a character from the buffer, converts it to 
integer. 


Indicates current position of mark. 

Increments and returns value of the N-register. 
Indicates current pointer position. 

Denotes decimal numbers. 

Gives current bounds of a region (.,# or #,.). 
Searches for and deletes a string. 

All of the buffer (0,Z). 


Returns N-register value. 
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Commands that 
Return a Value 
(Continued) 


Commands that 
Manipulate Numeric 
Values 


File Commands 


Flow of Control 
Commands 


Mark and Region 
Commands 


Miscellaneous 
Commands 


<NULL> 
<LF> 
<)> 
<ESC> 


<ESC> <ESC> 


Searches for and replaces a string. 


Searches for a string. 
Gives number of characters in buffer. 


Multiplication. 


Addition. 
Separates numeric arguments. 


Subtraction or unary minus. 

Division. 

Appends text from an input file to the end of the 
buffer. 

Opens a file for input and output. 

Closes an output file. 


Writes the buffer to an output file and reads a 
new buffer. 


Returns to the O/S without filing changes. 
Opens a text file for read. 

Opens a text file for write. 

Closes an output file; returns to O/S. 


Replaces buffer with a new page from input file. 


Conditionally exits from an iterative loop. 


Denotes an iterative loop. 


- Executes a T-register as CVTECO commands. 


Conditionally executes a region. 


Reads or sets mark position. 


Gives current bounds of a region (.,# or #,.). 


Ignored. 
Ignored. 
Ignored. 


Terminates string arguments; separates com- 
mands. 


Terminates a command. 
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Miscellaneous <SP> Ignored. 


Commands Puts comments into CVTECO command strings. 


(Continued) Serves as command modifier. 
@ Serves as command modifier for quoted string 
arguments. 
A“ Serves as control character prefix. 
N-Register % Increments and return values of N-register. 
Commands P Deposits values into N-register. 
O Returns value of N-register. __ 
Pointer Movement B Moves pointer backward by N characters. 
Commands C Moves pointer forward by N characters. 
J Moves pointer to position N. 
L Moves pointer to beginning of line. 
S Searches for a string. 
Printing Commands AE Prints a string. 
AP Toggles HARDEV. 
n:AS Converts n to a character and prints it on the 
COMDEV. 
AU Toggles COMDEV. 


= Prints a number. 
Prints part of buffer. 


T 
V Prints a window around pointer location. 


Search Commands — F Searches for and deletes a string. 
| R Searches for and replaces a string. 

S Searches for a string. 
Text Deletion D Deletes characters at pointer position. 
Commands F Searches for and deletes string. 
Text Insertion <TAB> Inserts a tab and a text string into buffer. 
Commands AS Converts integer to character and inserts result 

into buffer. | 
G Inserts T-register into buffer. 


Inserts text string into buffer. 
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Text Modification 
Commands 


7-Register 
Commands 


Commands Sorted 
Alphabetically 


< 


Searches for and replaces a string. 


Inserts T-register into buffer. 
Executes T-register as CVTECO commands. 


Extracts a text from buffer and puts it into 
T-register. 


0-9 Available to user. 
A-Z Available to user. 


This is a complete list of CVTECO commands sorted by ASCII value. 


<NULL> 
AC <char> 


AE<s>$ 
<TAB><s>$§ 


<LF> 
<)> 
AP 


n: AS 


nAS 


AT 


CAT 


AU 
<ESC> 


Ignored. 


Returns integer value of next character in 
command string. 


Types string argument on COMDEV or 
HARDEV. 


Inserts tab and string into buffer at current 
pointer location. (Equivalent to |< TAB> <s>). 


Ignored. 
Ignored. 
Toggles HARDEV. 


Converts n to a character; prints it on the COM- 
DEV. 


Converts N to a character: inserts it into buffer. 
(The reverse of 4 T.) 


Waits character to be typed; returns that 
character's integer value. 


Returns integer value of next character in text 
buffer, i.e., character following pointer. :AT 
returns zero if pointer is at the of buffer. 


Toggles COMDEV. 


Serves as a separater. ESCAPE can appear bet- 
ween any two commands; but cannot separate a 
command character from its numerical 
arguments. ESCAPE also terminates string 
arguments to commands. Two ESCAPE’s ter- 
minate a command string. 
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Commands Sorted <SP> 
Alphabetically 


(Continued) 


l<s>$ 


n# 


% <n-reg> 


/ 
0123456789 


n< 
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Ignored. 


Takes a text string argument which is treated as 
a comment. (! command does nothing.) 


Returns value of mark position. 


Moves mark position to location specified by 
numeric argument, i.e., position between nth 
and n+st characters. 


Increments N-register and returns its value. 
(% <n-reg> ="'OQ<n-reg> +1P<n-reg> 
$Q<n-reg>.” 


Multiplication, in expressions. 
Addition, in expressions. 


Separates numeric arguments in commands 
taking two arguments. 


Subtraction or unary minus, in expressions. 
Returns the value of the pointer position. 
Division, in expressions. 

A digit or a stream of digits is a decimal number. 
Modifier for other commands. 


Exits from current iterative loop if n=0. Other- 
wise, semicolon ignored. 


Denotes beginning of indefinite iteration loop. 
Exit from the loop is possible only when a search 
fails, or by invoking semicolon (‘’;’’) command. 


~ “<" must be followed by a matching “>.” 


Denotes beginning of iteration loop. Loop can be 
executed up to n times. Execution of loop fewer 
than n times is possible using the semicolon (‘’;’’) 
command. “n<” must be followed by a 


matching “>.” 
Prints value of argument on COMDEV. 


Denotes end of an iteration loop. ‘“>’’ must be 
preceded by a matching “<.” 
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Commands Sorted @ Can modify any command taking string argu- 


Alphabetically 
(Continued) 


ments. @ allows you to specify the character 
that terminates the. string. (.i.e., 
“<cmd><sil>$<s2>$" can also be typed as 
“@<cmd>/<s1>/<s2>/." 


A Indicates numerical argument; region delimited 
by pointer and mark positions. “A” = “.,#" or 
“HT ) 

B Moves pointer backward 1 position. “B” = 
“1B.” 

nB Moves pointer backward n positions tf n is 


positive; forward n positions if n is negative. 
“nB”’ — AC" 


C Moves pointer forward 1 position. ““C’ = “1C”. 

nC Moves pointer forward n positions If n Is positive; 
backward n positions if n is negative. ‘“‘nC’’ = 
“ +nJ.” 

D Deletes character after pointer. ““D’ = “1D.” 

nD Deletes next n characters after pointer if n is 


positive; n characters before pointer if n is 
negative. “nD” = “.,.+nK" or “.+n,.K.” 


EA Reads characters from file open for input, inserts 
them in buffer at end. EA reads as many 
characters as it would take to fill an empty buffer 
80% full. Repeated EA commands cause buffer 
to be paged to disc. 


nEA ~ Performs EA command n times. 


EB<s>$ Opens text file for editing. Filename specified in 
string argument. File is open for both input and 
output. “EB<s>$ = “ERsSEW<s>$§.” 


EF Closes output file. 


EP Moves on to next page of file being edited. Entire 
: buffer written into output file and buffer is 
emptied. More of input file is read into buffer. 

“EP” = “‘HEPSHKSEAS.” 


~nEP Performs EP command n times. — 
m,nEP Writes block of characters from positions m - n 
to output file. Block of characters is left in editing 
buffer. 
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Commands Sorted EQ<si>$<s2>$ 


Alphabetically 
(Continued) 
ER<s>$ 


EW<s>$ 


EX<sil>$<s2>$ 


EY 


nEY 
F<s>$ 


nF<s>$§$ 
m,nF<s>$ 


G<t-reg> 


nG<t-reg> 
H 
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Aborts all editing; returns to O/S. Any editing 
done is lost. When first string argument is not 
empty CVTECO passes control to command 
‘““<s1> <output-filenames> <s2>”. 


Opens a text file for input. Name of file specified 
by string argument. All subsequent EA com- 
mands read from this file. 


Opens a text file for output. Name of file 
specified by string argument. All subsequent EP 
commands write to this file. 


Finishes all edit operations; closes all files; 
returns to O/S. Any pages of input file not read 
into editing buffer are read in. All characters in 
editing buffer are written to output file. EX is 
normal way to finish editing, but when the first 
string argument is not empty, CVTECO passes 
control to command ‘’<s1> <output- 
filename> <s2>". 


Deletes all characters from editing buffer and 
reads a page in from file open for input. EY = 
“HKSEAS.”’ 


Performs EY command n times. 


Searches for first occurrence of the string argu- 
ment after pointer; deletes it. Pointer remains at 
position of string. F<s>$ = ".,ZF<s>$§.” 


Performs F<s> command n times. 


Moves cursor to position specified by m; 
searches for first occurrence of string argument 
after position m and before position n; deletes 
string; pointer remains at position of string. 
m,nF<s>$ = “m,nS<s>$Q.B,.K”. 


‘F identical to F command, but error not given 
when string not found. Value -1 is returned if 
search successful; 0 returned if search fails. 


Inserts text in indicated T-register into buffer at 
current pointer position. 


Performs G<t-reg> command n times. 


Numerical argument meaning entire buffer. H = 
"ZL. 
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Commands Sorted 
Alphabetically 
(Continued) 


I<s>$ 


nJ 


nk 


nL 


M<t-reg> 


nP<n-reg> 


Q<n-reg> 


Inserts string argument text into buffer at current 
pointer position. 


Moves pointer position to beginning of buffer. J 
— 0) i" 


Moves pointer position to location specified by 
numeric argument (between nth and n+st 
characters). 


Kills current line. Deletes all characters at current 
pointer position (up to and including end of line). 
K = IK. 


Kills n lines of buffer. If n = positive, nK deletes 
all characters between current pointer position 
(up to and including nth end of line). If n = zero 
or negative, nK deletes all characters (from 1-nth 
end of line before pointer position, up to current 
pointer position). 


Kills alll characters between mth and nth 
character positions in buffer. 


Moves pointer down to start of next line. L = 
eo Deen 


Moves pointer to beginning of line specified by 
numeric argument. If n = positive, pointer 
moves downward n lines from current pointer 
position. If n = zero, pointer moves to beginning 
of current line. If n = negative, pointer moves 
backward n lines. 


Executes indicated T-register as a CVTECO com- 
mand string. All arguments preceding M com- 
mand are passed to first command in T-register; 
any type of argument can be passed across end 
of T-register. The only restriction is that neither a 
conditional nor an interative loop may cross the 
“edge”’ of the T-register. 


Sets indicated N-register to value of numeric 
argument. 


Returns value of indicated N-register. 
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Commands Sorted 
Alphabetically 
(Continued) 
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R<si>$<s2>$ 


nR<si>$<s2>$ 
m,nR<sil>$<s2>$ 


S<s>$ 


nS<s>$ 
m,nS<s>$§ 


nT 


m,nt 


Searches for first occurrence of first string argu- 
ment after pointer; replaces it with second string 
argument. Pointer is left following new instance 
of second string argument. R<s1>$<s2>$ = 
"_ LR<si>$<s2>$." 


Performs R<s1>$<s2>$ command n times. 


Moves cursor to position specified by m. 
Searches for first occurrence of first string argu- 
ment after position m and before position n. 
Second string argument replaces first one; 
pointer is left following new instance of second 
string argument. m,nR<s1l1>$<s2>$ = 
“m,nF<s1>$i<s2>$,." 


Identical to R commands, except that error is not 
given when string Is not found. :R returns value 
-1 when search is successful; 0 if search fails. 


Searches for first occurrence of string argument 
after pointer; leaves pointer following that string. 


Performs S<s>$ command n times. 


Moves cursor to position specified by m; 
searches for first occurrence of string argument 
after position m and before position n. Pointer 
set to position at end of string. 


Identical to S commands, except that error is not 
given when string not found. :S returns value 
— 1 when search successful; 0 if search fails. 


_ Types current line, including all characters star- 


ting from current pointer position to end of cur- 
rent line. T = 1T. 


Types out buffer lines. If n = positive, types all 
characters from current pointer position to end 
of nth following line. If n = zero, types out all 
characters from start of current line to pointer 
position. If n = negative, types all characters 
from start of -nth line before current line to 
pointer position. 


Types out all characters between mth and nth 
character positions. 


Performs V command with default argument. V 
= Q.VV. 
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Commands Sorted nV Types out n-line window of buffer around cur- 
Alphabetically rent pointer position. V = -jTkT where j=n/2 
(Continued) and k=n-j. 


X< t-reg > Extracts text to end of current line from buffer; 
places it into indicated T-register. X<t-reg> = 
1X<t-reg>. 


nX< t-reg > Extracts buffer lines and places them in specified 
T-register. If n = positive, extracts all characters 
from current pointer position to end of nth 
following line. If n = zero, extracts all characters 
from start of current line to pointer position. If n 
= negative, extracts all characters from start of 
-nth line before current line to pointer position. 


m,nX< t-reg > Extracts all characters between mth and nth 
character positions; places them in indicated 
T-register. 

Z Returns number of characters in buffer. 

nlE Begins a conditional. All commands following 


“n[E” until the next ‘’]’’ are executed if n.E.0. 


nlG Begins a conditional. All commands following 
“n{G” until the next ‘’]’’ are executed if n.G.0. 


n{L Begins a conditional. All commands following 
“n[L” until the next ‘‘]’’ are executed if n.L.0. 


‘S<s>I([S Begins a conditional. All commands following 
“"S$<s>[$S” until the next ‘’]"’ are executed if 
search is successful. 


n{[~E _ Begins a conditional. All commands following 
“n[~E” until the next ‘’]’ are executed if 
n.NE.O. 

n[~G Begins a conditional. All commands following 
“n[~G”" until the next ‘‘]’’ are executed if 
n.LE.Q. 

ni~L Begins a conditional. All commands following 
“ni~L” until the next ‘J’ are executed if 
n.GE.0. 

‘S<s>[7S Begins a conditional. All commands following 


‘“S<s>[~S” until the next ‘’]’’ are executed if 
search is unsuccessful. 
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Commands Sorted m,nlE 
Alphabetically 


(Continued) 


commands following 
“)’" are executed if 


Begins a conditional. All 
“m,nlE’’ until the next 
m.E.n. 


commands following 
‘|’ are executed if 


Begins a conditional. All 
“m,n[G”’ until the next 


m.G.n. 


A <letter> 


AB 


Break Character 


ACAC 
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Begins a conditional. All commands following 
““m,n{L’’ until the next ‘’]’’ are executed if m.L.n. 


Begins a conditional. All commands following 
“m,ni~E” until the next “]’’ are executed if 
m.NE.n. 


Begins a conditional. All commands following 
“m,n[~ GG” until the next ‘’]’’ are executed if 
m.LE.n. 


Begins a conditional. All commands following 
“m,n{[~L”’ until the next ‘‘]’’ are executed if 


m.GE.n. 
Ends a conditional. Must be preceded by a 
matching “‘[”’ command. 


Converts following character into a_ control 
character; causes that control character to be ex- 
ecuted as a command. 


Lowercase commands are equivalent to upper- 
case counterparts. 


Command break character. When typed during 
command execution, it causes immediate return 
to system prompt. When typed while CVTECO is 
typing, it acts as a print control character; it 
causes CVTECO to wait until a 1, Q, N, or other 
character is typed. 


Task abort characters. Two consecutive C’s 
cause CVTECO to abort; control returns to O/S. 
All edits are lost, except those put into files 
already closed with an “EF” command. 


Other 


DATE 


PURPOSE 


SYNTAX 
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0-9 Available to user. 
A-Z Available to user. 
A | Argument to V command executed automati- 
cally after every search. 
.B Pointer position before previous’ search 
command. 
.D A nonzero value causes command string to be 


echoed when it is executed. 


ee) Pointer position at start of string found by last 
successful search command. 


Default argument to V command. 
.W Width of carriage on COMDEV/HARDEV. 


= 


Types out current system date and time. Control automatically returns to 
O/S level. 


DATE 
Example 


n> DATE) 
12-10-80, 7:31:02 
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DELETE 
PURPOSE Deletes disc files and catalogs. 


SYNTAX DELETE[/Options] 
[Catalog[/[Filenamelist] [/Options]]] 


Example 
Deletes files in CAT1.SUBCAT1.SUBSUBCAT: 
n> DELETE CAT1.SUBCAT1.SUBSUBCAT//ASK } 


CAT1.SUBCAT1.SUBSUBCAT.&BCD.FILE 
TYPE “OK” TO DELETE 


OK) 


CAT1.SUBCAT1.SUBSUBCAT.&BCD.FILE DELETED 


CAT1.SUBCAT1.SUBSUBCAT.FILE 
TYPE “OK” TO DELETE 


OK )} 
CAT1.SUBCAT1.SUBSUBCAT.FILE DELETED 
COMMENT DELETE is a FUTIL subcommand as well as an O/S level command. The 
FUTIL section contains additional documentation. (See the FUTIL Over- 
view or the Index under FUTIL, DELETE.) 


3-42 


DETACH 


PURPOSE 


SYNTAX 


COMMENTS 


MESSAGES 


DETACH 
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Unattaches a unit from particular task. 
DETACH Taskunitname 


Taskunitname = two-character name assigned by task to this unit (see 
Attach). 


e If you are detaching the COMDEV, HARDEV, PPTDEV, or CARDEV, 
the unit is also released in this capacity. (See SELECT command.) 


When COMDEV is detached, the execution mode remains unchanged. 
If the COMDEV is detached and the task attempts to perform I/O to the 
COMDEV, task execution is suspended until the COMDEV is reattached. 
Avoid this problem by selecting NOECHO before detaching the COM- 
DEV. (See SELECT command.) 


Control automatically returns to the system. 


MT UNATTACHED Indicates successful detach of 
taskunitname MT. 


BAD REQUEST Taskunitname is bad. 
CANNOT RELEASE COMDEV LEAVING Task COMDEV is being detached; 
ANOTHER UNIT NAMED SD the Taskunitname is not SD; and 


another unit attached called SD. 


3-43 


DO 


DO 
PURPOSE 


SYNTAX 


Generating 
Commands 


COMMENTS 


The information and drawings contained herein are the sole property of Computervision 
Corporation. Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
express written consent of Computervision. . 


Generates system command to process a text or overlay file. 


DO filename[/Options] 


Options 


COMPILE 


LOAD 
EXECUTE 


RUN 


Apply to the system command that DO executes. 


lf first two characters of any line are ‘C ‘; if 
SUBROUTINE or FUNCTION are first words on any line 
(beginning in column 7 or beyond); or if E:F, E:O, or 
ASSM are first words in any line (past column 2). 


If words INSERT, CORORG, BLOCK, or LOADSYM 
begin any line. 


lf words COMPILE, LOAD, PRINT, PRINTLP, OR DO 
begin any line. 


When file is not a text file; if nothing above applies; and 
if file is in an overlay created by the loader WRITE com- 
mand. 


DO executes a system command based on file contents. 


If the file is a text file containing key words as listed below, either LOAD, 
COMPILE, or EXECUTE is invoked. 


If file isn’t a text file, or DO cannot determine proper action, it attempts 
to execute the RUN command. 


Since file contents do not always follow rigid rules, DO may refuse to 
process files acceptable to COMPILE, LOAD, EXECUTE, or RUN. 


DSABDIR 
PURPOSE 
SYNTAX 


COMMENTS 


MESSAGES 


DSABVOL 


PURPOSE 


SYNTAX 


COMMENTS 


MESSAGES 


DSABDIR 
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Disables current user-specified working directory. 
DSABDIR 


Disables search list created with ENABDIR. The file manager uses this list 
to search for files. All further file references are searched for in the primary 
system catalog. 


NO TASK BASED DIRECTORY IS No directory exists for the task. 
ENABLED FOR THIS TASK 


DIRECTORY DISABLED Successful DSABDIR. 


Disables an auxiliary volume, allowing it to be physically removed from the 
system. 


DSAVBOL volume name 

DSABVOL :ALL 

e Disable given volume previously detached (or all auxiliary volumes if 
:ALL argument given). (See DTCHVOL). The volume name is removed 


from the primary disc catalog. 


e When the volume is disabled, the following information is output. The 
volume can now be physically removed from the system. 


VOLUME # VI “Volumename”’ 

PACK ID PARTS PACK “Pack ID” 

DISABLED ON DRIVE # 1 “Logical drive number’ 
HARDWARE DISC ERROR Disc Error or drive not on line. 
WRONG VOLUME ON DRIVE Expected volume not on drive. 
VOLUME IN USE Volume still attached to a task or a 


file is still In use. 


VOLUME NOT ENABLED Requested volume not in system 
primary catalog. 
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DTCHVOL 

PURPOSE | Detaches an auxiliary disc volume from a task. 

SYNTAX : DTCHVOL volume name 

COMMENT DTCHVOL removes association of a volume to a task. When detached 
from all tasks, the volume may be disabled (see DSABVOL). 

DUMP 

PURPOSE Dumps task memory. 

SYNTAX DUMP XXXX1 [-YYYY1] . . .[,XXXXN [-YYYYN]] 


Where XXXX and YYYY = lower and upper hex bounds, respectively. 


FORMAT Each line of the dump has the format: 
START HEX DATA HEX DATA 
ADDR FOR FOR 
(HEX) START ADDR START ADDR 
| +0 +7 


dump of 8 hex words 


Format is followed by each byte’s ASCII representation 
(non-displayable characters output as periods). Four 
dots (....) represent core constant (OCOF). Lines iden- 
tical to preceding line not printed. First identical line 
indicated by four dots(....) in place of start address. 
Control automatically returns to system upon dump 


completion. 
Example 
DUMP 0-20 Dump core locations 
0-20. System outputs, 
0000 7809 4907 0501 7A9QF 0D63 0000 14D4 OOOO usgaarondveas T.. 


0008 1516 7005 0007 0000 711E 7833 7808 qh). eer or re ) 
0010 0260 T11E 0001 0000 29AC 2986 11A3 LOO = AStsensy ee 5: 
0018 15CC C005 FFO1 1F85 C005 16CC 271B 20F6 .L@..@..L...v 
0020 7AF1 | 
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DUMPERR 

PURPOSE Prints system error information. 
SYNTAX DUMPERR 

MESSAGES 1. Type pievsionn error: 


**ERROR CALL XXXX** 
(XXXX = argument that called system error routine.) 


2. Location where system error generated. 
Location which violated mapper protection (FFO4 and FFO5 errors only). 


3. Contents of ACO,1,2, and 3 on system error. 
4. Roll table on system error. 
Example 

n> DUMPERR ) 


FROM LOCATION 203B System output. 

AT LOCATION 7900 

AC0-3 

0888 17C6 2171 7900 

ROLLTAB 

2000 0E71 

**ERROR CALL FFO4** 

WRITE VIOLATION: ATTEMPT TO WRITE READ-PROTECTED MEMORY 
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PURPOSE Examines file contents. 
SYNTAX DUMPFILE catalog.file 
Catalog.file = the file to be examined. 


INPUT/OUTPUT n> DUMPFILE 


Buffer Management OFFSET 
Commands 


FILESIZE 


Buffer Examination DUMP 
Commands 


SEARCH 
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Enter command along with Catalog. file. 


System prompt. Indicates that it is waiting for a 
command. 


OFFSET [or OF] =val 


Establishes an offset to the start of the buffer. The first 
word in the buffer will have an address of val (base 16). 


FILESIZE [or FS] 


System responds with file size in hex words. In the 
following commands, all occurences of the word /ocn, 
where n is a decimal digit, represent buffer addresses in 
the range: 


OFFSET < locn s FILESIZE -1 


DUMP [ locn ] [ locn ] 
D [loc1-loc2], [loc1-loc2],... 


Dump prints (in hex) all values between loc1 and loc2. 
When no ranges are specified, entire file is dumped. 
Output format is: 


loc! XXXX XXXXK XKXXK XKKK KXKXKK KKKXK 
loc! +8 


SEARCH [ loc ] [ loc ] 
SR [loct-loc2], [loc1-loc2],... = value 


SEARCH prints all buffer locations that fall into 
specified ranges with contents equaling value. When 
range is not specified, entire buffer is searched. Output 
format Is: 


loct value 
loc2 value 


Miscellaneous 
Commands 


Terminating 
Commands 


MESSAGES 


NOTE 
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SUM 


SUM [or SU] loct-locn 


SUM adds values of consecutive words in the buffer. 
SUM only produces single-precision results. 


QUIT QUIT [or Q] 


QUIT returns you to O/S. QUIT is the only way to exit 


the processor. 


BAD COMMAND 


BAD LOCATION 


NEGATIVE RANGE 


See also PACHFILE. 


DUMPFILE does not recognize 
command. 


Buffer address being examined or 
modified is outside permitted address 
range. In commands _§ specifying 
ranges: if either end of a range is 
beyond the buffer limits, command ts 
not performed for that range. When 
multiple ranges are specified: com- 
mand is performed for all ranges that 
satisfy the boundary check. 


Upper bound of a range pair is less 
than the lower bound. 
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Hex bounds list; dump bounds 
for each record; negative bound 
counts for end of record (e.g., 0, 
FFFF = first and last words). 
Default bounds are the entire 


N Dump N records from the cur- 
rent tape position. 


Skip N records (-N = back- 


Skip N files (-N = backwards). 


DUMPTAPE 
PURPOSE | Magnetic tape dump. 
SYNTAX DUMPTAPE [Tapename] 
Where Tapename = _ user-assigned task name for tape unit (see 
ATTACH). Default is MT if Tapename omitted. 
~ INPUT/OUTPUT n> DUMPTAPE ) Enter command. 
# The system returns with a prompt (#), indicating 
it is waiting for a command. 
Commands 
R Rewind. 
B N1-N2,... 
record. 
D 
SRN 
wards). 
SF N 
0) Quit. 
MESSAGES **BAD KEYWD** 


Invalid command entered. 


EDIT 


PURPOSE 


SYNTAX 


To Invoke EDIT 


EDIT 
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Manipulates text files. EDIT is a line-oriented editor that prompts for text- 
processing commands. 


EDIT Catalog.file [OPTIONS] 


OPTIONS 


NEWCAT = newcatalog 


EDIT attempts to open the file newcatalog.catalog. 
&BCD.file for editing. If it doesn’t exist, EDIT searches 
for catalog.&BCD.file. If that file is found, it is opened 
for editing as newcatalog.catalog.&BCD.file. (The 
Original version, catalog.&BCD. file, is unaffected by the 
edit session). NEWCAT=newcatalog can be 
abbreviated with N = newcatalog. 


NEWCAT 
Your Login Name will be used as newcatalog. NEWCAT 


is equivalent to NEWCAT = Login name. The abbrevia- 
tion for NEWCAT is N. 


Sample dialogues for opening a file to be edited at O/S level: 


e Without NEWCAT 


n> EDIT Catalog.File ) Tells EDIT to open the file for editing. 


If file exists in catalog.&BCD it will be 
opened. Otherwise, the system 


responds: 
TYPE OK Enter OK ) to create the file 
TO CREATE NEW FILE: newcatalog.catalog.&BCD.file for 


editing. 


Any other response aborts EDIT and 
returns control to the O/S. 
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EDIT 


To Invoke EDIT 
(Continued) 


Line Numbers 
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With NEWCAT 
n> EDIT catalog. file/NEWCAT = newcatalog } 


newcatalog.catalog.&BCD. file is 
opened if it exists. Otherwise, EDIT 
copies catalog.&BCD.file into 
newcatalog.catalog.&BCD.file and 
opens it for editing. If neither file 
exists, EDIT prints the message: 


TYPE OK Enter OK } to create 
TO CREATE NEW FILE: newcatalog.catalog.&BCD.file. 


Any other response aborts EDIT and 
returns control to the O/S. 


Once the file is open, the # prompt indicates that EDIT is ready to accept 
commands. To end the session and return to O/S level: 


e F ) saves the work. 
¢ Q)} terminates without saving any changes. 


Other F commands (FC,FE,etc.) will save the buffer and then enter an O/S 
level command. 


EDIT is a line-oriented editor. Most commands operate on lines or 
sequences of lines specified by decimal line numbers. Line numbers are 
internal to the editor; they are not physically represented in the the file 
being edited. 4 


e Any command that accepts a range of lines will also accept a single 
line. 


e When a line number beyond the end of the file is given as a command 
argument, EDIT substitutes the last line number of the file. This is true 
for every command except D (Delete), which will generate an error if a 
line number argument exceeds the last line. 


e Insertion lines are forced into the range of one to the last line of the 
file. 


e With insertion commands (C,I,M and X), a destination line of 0 inserts 
text before the first line of the file. 


EDIT 
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Renumbering The following EDIT commands automatically renumber the file: 


T,TH,TV (TYPE LINES) 

L,LD,LDC,LE (LOCATE LINE) 

S (SUBSTITUTE TEXT) 
A,F,FC,FE,FL,FR,FS,FX (FILE CHANGES) 
J (JUSTIFY LINES) 


— Text inserted or modified after renumbering is not available for 
inspection (or modification) until another renumbering command 
is issued. 


— The message: EDIT BUFFER IS FULL is output when a great deal 
of text has been modified without renumbering. To continue 
editing, issue one of the renumbering commands. 


— Anerror or ESC QO entered from the keyboard can interrupt the 
execution of many EDIT commands. This type of interruption 
does not affect text already modified. Reissue the command to 
modify any remaining text. When an error interrupts command 
execution, EDIT will indicate the extent of buffer modification 
prior to the error. 


String-Oriented L and S are string-oriented commands. They search the file, or portions of 
Commands the file for a particular sequence of characters (a string). There are two 
types of strings, Word strings and normal strings. 


Word strings are limited to alphanumeric characters. When a word 
string is specified in an L or S command, that sequence of characters 
will only be recognized within text if it is surrounded by special 
characters, blanks, or line boundaries (end-of-line, beginning-of-line). 
In the Land S command syntax, word strings are represented literally; 
delimiters are not allowed. 


Alphanumeric Characters — The characters 0-9, and A-Z are 
alphanumeric. No special characters are alphanumeric. 


Normal strings can be composed of any characters. There are no con- 
straints as to whether a normal string must be surrounded by special 
characters when it occurs in text. When used in an L or S command, 
however, a normal string must be surrounded by a pair of matching 
delimiters. 


Delimiters — In string search syntax, any special character except a 
space or an & can function as a delimiter. 
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EDIT 


Sample String 
Search 


Commands 
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n> EDIT JPR.SAMPLE })} Opens the file for editing; T lists the 
file’s contents. 


#T 
111 SAW 1D0G AT THE ZOO 
2!1D0G WAS MARCHING 
S!IHERE’S 1D0G; A HOTDOG, 
411 SAW 21D0GS TODAY 
5!THERE ARE NO DOGS HERE 
6!HERE IS 1DOGGIE 
7!| SAW1DOG ON THE STREET 


L,1DOG Word string search for all lines con- 
1!| SAW 1D0G AT THE ZOO taining string 7dog. 
2!1D0G WAS MARCHING 
3!HERE’S 1D0G; A HOTDOG, 


L,/1DOG/ Normal string search for all lines con- 
111 SAW 1D0G AT THE ZOO taining string, 7dog. Observe changed 
2!1D0G WAS MARCHING results. 


3!IHERE’S 1D0G; A HOTDOG, 
411 SAW 21D0GS TODAY 
6!HERE IS 1DOGGIE 

7!| SAW1DOG ON THE STREET 


(A carriage return ()) must terminate all commands.) 
A SYNTAX A catalog.file 


Files changes in an auxiliary file. The buffer is written to 
catalog.&BCD.file (this name Places the modified file from the 
current session in catalog.&BCD. file, which must not have the 
same name. A does not does not terminate EDIT. 


B Enables work in upper and lower-case. Entry default is the task’s 
entry case state. When EDIT terminates, the task case state 
returns to its condition at entry. 


C SYNTAX C linea [lineb], linec 


Copies specified lines. Inserts a copy of the block from linea to 
lineb after linec. 
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D 


Space 


Other 


SYNTAX _D linea [-lineb] 
Deletes specified line(s). 
SYNTAX E line [/columna [-columnb]] 


Edits a line between specified column positions, enabling you to 
modify the line character by character. The section to be edited is 
between columna and columnb. If neither columna nor columnb 
is specified, the whole line is edited. If columna only is specified, 
the line is edited from columna to line’s end. 


Delimited characters are typed out without the line number; the 
Carriage returns to the first column under this line, and modifica- 
tion characters are entered under specific characters to be 
modified. Columns beyond the end of this line act like trailing 
spaces and may be modified just like any other character in the 
line. Modification characters affect the character under which 
they appear. 

No effect; retains old character. 

Blanks out old character and turns it into a space. 


Deletes old character. 


Note 
Valid characters may be deleted when \ is 
used to delete spaces beyond the end of the 


line. 


Inserts all characters following the [ before the old character; 
including all modification characters described here except ]. 


Terminates insertion started by [. Acts like a normal character 
unless it follows [ insertion. 


Terminates modification instructions and types the line with 
requested modifications. Also terminates insertion started by [. 


Any other characters will replace existing characters. 
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FC 


FE 


FL 


FR 


Modifications may be entered after ] terminates an insertion 
started by [. Although additional modifications begin with the 
character that [ appears under, they are not aligned with the 
modification line owing to the [] pair and any intervening 
characters. 


Once ) terminates the modification instructions, a modified line 
is typed out without a line number and may be further modified. 
Characters in the line that follow the }) position are modified as If 
spaces had been typed beneath them, i.e., they remain the same. 
» at the beginning of the modification line terminates E. 
SYNTAX F 

Quits and files all changes. Terminates EDIT and files text 
modifications. Changes from the current session become a per- 
manent part of the file. | 

SYNTAX FC [/options] 

Files the modified file and invokes the compiler. Identical to F 
except that it compiles the changed file. All options are passed to 
COMPILE for validation. 

SYNTAX FE 

Files and EDITs the modified file. Identical to F command except 
that it reopens the save file for editing. This is as if you terminated 
with F and then invoked EDIT from the O/S. 

SYNTAX — FL [/options] 


Files and LOADs the modified file. Identical to FC except that it 


invokes LOAD instead of COMPILE. Its options are those of 


LOAD. 
SYNTAX FR command [filename] [/options] 


Files and runs the specified command. Identical to F except that 
it invokes a specific command after saving the file. Both filename 
and command-specific options are options of the specified com- 
mand. If the character string $$ replaces filename, the name of 
the saved file minus the &BCD catalog level is used in its place. 
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FS 


FX 


LD 


SYNTAX FS 


Files and SUBMITs for execution. Identical to F except that the 
modified file is submitted to be executed by the batch processor. 


SYNTAX FX 


Files and EXECUTEs. Identical to F except that it invokes 
EXECUTE to input system-level commands from the saved file. 


SYNTAX | [line] 


Inserts text after line. If line omitted, text will be inserted before 
line 1. 


SYNTAX J [linea [lineb]], [T]n 


Left-justifies lines. The lines are adjusted so that the first non- 
blank character is moved to column n (or tab stop Tn). EDIT 
types the original line, followed by the modified version. Lines 
that are already justified properly will not be modified or listed. If 
line numbers are omitted, the whole file is justified. 


Note 


System tab stops are positioned with <tab> 
or <control-l> keys. Column and tab stop 
numbering starts at 1. 


SYNTAX _ LIlinea [-lineb]], string 


Locates lines containing string. Searches the line or range of lines 
for specified text string. If a line contains one or more occur- 
rences of the string, EDIT types the line preceded by its line 
number. If no line numbers are specified, the whole file is 
searched. 


SYNTAX LDllinea [lineb]], string 


Locates and deletes lines. Identical to L, except that each line Is 
deleted (D command executed for that line) after it is typed out. 
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LDC 


LE 


SYNTAX LDCllinea [-lineb]], string 


Locates and deletes on response. Identical to LD, except that you 
are prompted for confirmation of the delete. A Y response means 
to delete the line, any other response will go on to the next line 
without deleting the line in question. 


SYNTAX LE[linea [-lineb]], string 


Locates and edits. Identical to L, except that each line found is 
edited (E executed for that line) before going on to next line. 


SYNTAX  M linea [-lineb],-linec 


Moves specified lines. Identical to the sequence: 


C iinea [-lineb], linec 
D linea [-lineb] 


If linec is not specified, linea-lineb wvill still be deleted. 
SYNTAX Nn 


Allots n spaces at the start of the line for a line number. 
Whenever EDIT lists a line, it prefixes the current line number to 
the text. This line number is separated from the body of the line 
by an exclamation point (!). n is the number of digits (including 
the exclamation point and leading spaces) that the line number 
can occupy. If the digits in a line number exceed n, only the right 
hand digits will be printed. The default spacing for line numbers is 
6. 


SYNTAX Q 
Quits without filing changes. Control returns to the O/S. No 


changes from the editing session are filed. This is really a user- 
abort of the editor. 
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R 


TH 


SYNTAX  R linea [-lineb] 


Replaces specified line(s). R linea [-lineb] is equivalent to: 


D linea [-lineb] 
| = linea 


Caution 


R_ linea [-lineb] will delete linea [-lineb] 
regardless of whether replacement lines are 
entered. Once R has been typed, the deletion 
cannot be revoked. 


SYNTAX. S [linea [-lineb]], stringa, stringb 


Substitutes one text string for another. Searches for stringa; 
replaces stringa with stringb. Within the line range, every occur- 
rence of stringa is replaced, including multiple occurrences within 
a single linee. Each time a substitution is made, old and new ver- 
sions of the line are typed out. If no lines are specified, the whole 
file is searched. 


Note 

Do not include leading spaces in stringa or 

stringb. 
SYNTAX T [linea [-lineb]] 
Types lines. If specified, linea through lineb will be listed. If lineb 
is omitted, linea through the end of the file will be listed. T with 
no line numbers will list the entire file. EDIT renumbers the file 
before typing requested lines. 
SYNTAX TH [linea [-lineb]] 
Types pages with version and page numbers. Identical to TV, 


except that output is broken up into pages. Each page is headed 
by filename, date, time, and page number. 
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TV 


SYNTAX TVi{linea [-lineb]] 


Types with version. Identical to T, except that full filename 
(including &BCD catalog level) and the file’s date and time are 
typed before any requested lines are typed. 


SYNTAX U 


Forces new text to uppercase. Existing text is kept in original 
case. Case default depends on the current case state of the task. 
This case state will be restored at the end of the editing session. 


SYNTAX Win] 


Sets maximum number of characters in line. All file lines are trun- 
cated to n characters in length. I, E, R, C, Mand S commands all 
truncate the lines resulting from their execution. T does not 
physically truncate any lines; T only types n initial characters in 
the lines. L does not locate any text beyond n characters in the 
lines. The default for n upon entry to the editor is 72. The limits 
fornis: 0 < numchars < 80. If W is specified without the n argu- 
ment, the width is returned to the default (72). 


SYNTAX X catalog.file, linea [-lineb], linec 
Extracts lines from external file. Copies linea through lineb from 


file catalog.&BCD.file; places them after linec in the file being 
edited. 


EDITCMTB 


The information and drawings contained herein are the sole property of Computervision 
Corporation. Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
express written consent of Computervision. 


EDITCMTB 
PURPOSE Edits command table (CMTB). 
SYNTAX EDITCMTB filename [,N] 


Where filename = name of File Manager COMMTAB to be edited. Use N 
option for file that does not yet exist. 


COMMENTS e EDITCMTB prompts (#), indicating that it is waiting for an EDITCMTB 
command. 


e ITCMTB commands are single or double-character mnemonics followed, 
if appropriate, by parameters. 


e All line numbers are in decimal. If a line number (given as parameter) 
exceeds the number of lines in the COMMTAB, the number of the last 
line is used. A single line number may be substituted for a range of line 
numbers. 


e Insertions, deletions, replacements, copying, moving, and extracting do 
not take place immediately; they happen when COMMTAB lines are 
renumbered. To renumber, enter one of the following commands: Type, 
File, or Locate. 


e Lines in a COMMTAB file are limited to 655. This includes deleted, 
replaced, and old position moved lines until renumbering takes place. 
The message, NOT PROCESSED: COMMTAB FULL, indicates that the limit is 
reached. Renumbering may then alleviate the problem, unless the 
renumbered COMMTAB contains 655 lines. 


COMMANDS Command Syntax Meaning 


INSERT | {LINE #] 0 assumed if line # is omitted. 
Insert subsequent lines after 
specified line. Terminate inser- 
tion with RETURN in response 
to an argument query for a line. 
Enter a line by responding to 
argument queries as follows: 
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NAME 
DLOC: 


CORC: 
CORL: 
STRT: 
FILE: 


Normal Entry Query Response 


Command name (max, characters: 8). 

Hex offset in overlay file. 

If anything but FFFF entered for DLOC, 
normal entry queries are asked: CORC, 
CORL,STRT,FILE (max. characters: 4). 

Hex core count. 

Hex core location (max. characters: 4). 

Hex start location (max. characters: 4). 
Filename of overlay to execute (max. 
characters: 80). 


If reply of FFFF is entered for DLOC, queries following 
DLOC will be as follows: 


NAME: 
DLOC: 
XNAM: 
STRT: 
Note: 
Command Syntax 
DELETE 
REPLACE 


D line a [-line bl] 


R line a [-line b] 


Cross-reference Entry Query Response 


Command name (max. characters: 8). 
FFFF (max. characters: 4). 
Cross-referenced command name 
characters: 8). 

Hex relative start location (max. characters: 
80). 


(max. 


You can’t cross-reference to an entry that 
has been cross-referenced. 


Meaning 

Deletes specified lines. 
Replaces specified lines by 
lines subsequently typed in. 


REPLACE is equivalent to: 


D line a [-line b] 
| linea 


Terminate replacement by hit- 
ting RETURN in response to an 
argument query for a line. 
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COMMANDS TYPE T [line a [-line b]] Types specified lines. All lines 

(Continued) are typed if there is no specifi- 
cation. Lines are numbered in 
the following format: 


Normal Entries 


COMMAND _ FILE CORE START 
NAME DLOC COUNT LOC 


CORE IMAGE FILE NAME 


Cross-Reference Entries 
COMMAND REFERENCED 


NAME COMMAND + += OFFSET 
NAME 
TYPE WITH 
VERSION TV [line a [LINE B]] Types filename, date, and time 
of file creation, and specified 
lines (as with the Type 
commandq). 
QUIT @] Terminates EDITCMTB with- 
out updating COMMTAB file. 
FILE F Updates COMMTAB file; ter- 
minates EDITCMTB. 
EDIT E Edits a line. Line fields are out- 


put like the Type command. To 
change fields, retype them at 
appropriate field position; new 
values will replace old fields. 
Entries cannot be changed from 
normal to cross-referenced en- 
tries or vise versa. Once entire 
entry is redisplayed (with 
modifications) and no more 
changes are made, EDITing of 
that line is complete. For nor- 
mal entries, two lines of fields 
are displayed (and may be 
modified) for each entry. 
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Example 


Line 3 = ABC 2 100 2900 0 


X.Y 

Edited Line 3 Output 
# 
E3 

ABC 2 100 2900 0 

A 600 2900 200 
X.Y 
X.YY 

A 2 600 2900 200 

X.YY 
# 

Command Syntax Meaning 

COPY C line a [-line b], line c | 
Inserts a copy of /ine a - line b 
after line c. 

MOVE M line a [-line b], line c | 
Same as COPY except that /ine 
a-line b are deleted after copy is 
made. 

EXTRACT X filename, line a [-line b], line c 
COPY /ine a-line b from COM- 
MTAB file, filename is inserted 
after line c. 

LOCATE NAME LN name Locates all instances of com- 
mand name name, either as a 
command name or _ cross- 
referenced command name; 
prints all lines containing name. 

LOCATE FILE LF filename Locates all instances of file 
with name filename as a core 
image file; prints all lines con- 
taining filename. 

SORT S Alphabetically sorts entries in 
COMMTAB by command 
name. 
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ENABDIR 

PURPOSE Enables user-defined working directory for current task. 

SYNTAX ENABDIR {catalog[OPTION], filename =F}, ... 

INPUT catalog Specifies a catalog as one of the entries in a task- 


oriented directory. This directory is a search list for files 
referenced by the task. When existing files are refer- 
enced, only the catalogs listed in the search list (in the 
order specified), will be searched. 


OPTIONS =G, =L, or =C may be appended to each catalog 
name. These options indicate one or two catalogs 
where files will be created. ENABDIR allows GLOBAL 
and LOCAL create catalogs. If more than one catalog is 
flagged as the GLOBAL or LOCAL catalog, the last 
entry takes precedence. 


=G Catalog is flagged as GLOBAL. Files will generally be 
created in this catalog. 

=L Catalog is flagged as LOCAL. Under GNA, the LOCAL 
catalog may be used for files created at the satellite 
node. 

=C Flags the catalog as CREATE (GLOBAL and LOCAL, 


unless otherwise specified). 


The first catalog entry is initially set to be both the 
GLOBAL and LOCAL create catalog. =G or =L will 
override this default. 


filename = F Designates a text file containing catalog names to form 
the search list. In the text file, catalog names must start 
in the first column of each line; use the OPTIONS =G, 
=L, or =C just as you would on the command line. 
Comments may be added to the file to document 
catalog usage. Indicate comment lines with a double 
asterisk (**) in column one. =F must be appended to 
the filename, this distinguishes it from a catalog name. 
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e More than one filename may be used. The option =F may not be 
specified from within a text file. 


e To continue a command line, use a semicolon (;) before the }. 
e Catalog names may not exceed 78 characters in length. 


e Catalogs in the search list need not currently exist on the system. 
Volumes, however, must be in existence. 


e A working directory cannot exceed six catalog entries. 


DIRECTORY CURRENTLY Output when a directory is currently 
ENABLED TYPE OK TO enabled for the task. 
OVERWRITE 


Type ‘OK’ to enable a new working 
directory. 


DIRECTORY ENABLED Printed when directory is suc- 
cessfully enabled. Otherwise, ap- 
propriate error message is output. 


Example 


n> ENABDIR JOC=G,SYSCATLG=L } 
DIRECTORY ALREADY EXISTS 
TYPE OK TO OVERWRITE 
OK ) 
DIRECTORY ENABLED 
n> LISTDIR ) | 
CREATE CATALOGS ARE: 
GLOBAL: JQC 
LOCAL: SYSCATLG 
1)JQC 
2)SYSCATLG 
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Enables an auxiliary volume that may be used by the file manager. 
ENABVOL logical drive number. 


Puts volume name of pack mounted on given logical drive in the primary 
volume system catalog; enables the volume for use by file manager. 


The following is output when volume is enabled: 


VOLUME = volume name 
PACK ID = pack /D 
ENABLED ON DRIVE = /ogical drive number 


To access the volume by a task, the volume should first be attached (see 
ATCHVOL). The volume may be accessed without ATCHVOL. (The prime 
purpose of ATCHVOL is to prevent the disc from being disabled while it is 


in use.) 

HARDWARE DISC ERROR Caused by disc error or not on line. 

PROTECTION VIOLATION You are not allowed access to 
pack. 

VOLUME NAME ALREADY EXISTS Primary volume catalog already 


contains entry of same name as 
volume name. 
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Processes an execute file containing O/Y level commands. 
EXECUTE catalog. file 
Commands are contained in the text file cata/og. & BCD. file. 


The contents of the execute file are processed as if they were commands 
typed in from the COMDEV. The execute file can include all forms of task 
input, including: O/S commands, subcommands (such as within EDIT or 
COPY), answers to prompts, CADDS entry and CADDS commands. 


During file execution, only pause/break characters and COMDEV 
DETACH characters are accepted from COMDEV (see SPECIAL 
CHARACTERS). 


All commands, except FMCLEAR, are legal in an EXECUTE file. Files may 
be nested by including an EXECUTE command within a file. Characters <, 
|, and % have special meanings described later. A pair of these characters 
should be used to represent a single one. 


To allow EXECUTE files to be edited and printed, control characters and 
special functions must be represented within the file as special sequences 
of printing characters. 


Every line of a text file must end with <CR>; however, this carriage 
return may be part of a non-executable comment so that it has no effect. 
Extra <CR> may be included by using the following abbreviations, allow- 
Ing multiple commands on one line of the text file. 


Use for documentation, benchmarks, and EXECUTE files. 


Syntax Meaning 

<CR> Extra carriage return 

<ILr > Line feed 

<BELL> Rings bell on COMDEV, if echoed* 
<TAB> Horizontal tab 

<VTAB> Vertical tab* 

<BACKSP> Backspace 

<PAGE> Form feed, start new page on printer 
<ESC> Escape (or Alternate Mode)* 
<ESCAPE> Escape (or Alternate Mode)* 
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Syntax 


<RUB> 
<RUBOUT> 
<NULL> 
< PRINT > 
<ECHO> 
< ABORT > 
<CTRL-X> 
<CTRL-P> 
<CTRL-Q> 
<AX> 

< AP> 

< AQ> 
<*> 

<* 

< 

<< 
<VAR> 


Meaning 


Rubout 

Rubout 

Null character 

Toggle HARDEV on/off (Control-P)** 

Toggle COMDEV echoing on/off (Control-U)** 
Ignore whole line (Control-Q) 

Control-X, X= any alphabetic character 
Toggles HARDEV, equivalent to <PRINT> 
Ignore whole line, equivalent to < ABORT > 
Control-X, X=any alphabetic character 

Toggle HARDEV, equivalent to <PRINT> 
Ignore whole line, equivalent to < ABORT > 
Ignored 

Ignored, used to continue to next line or 
Ignored, used to continue to next line 

< 

Accept variable input from user (Implemented in 
CADDS only) 


*Used only in CVTECO Execute files. 
**Used only in O/S Execute files (not in CADDS). 


For those terminals that do not support the following characters; the 
characters themselves may be used when available: 


< TILDE> 
<UNDRSCOR> 
<VERTBAR> 
<BACKSLSH> 
< LFTBRACE> 
<RGTBRACE> 
<CARET > 


~ (tilde) 
__. (underscore) 

| (vertical bar) 

\ (backslash) 

{ (left brace) 

} (right brace) 

A (caret or up-arrow) 


Short forms consist of a caret (A), or up-arrow, followed by one of several 
characters. They minimize key strokes but decrease readability. 


Syntax 
AX 


A| 
AU 
AP 
AM 


Meaning 


Control-X (X = any alphabetic character; i.e., AA, 
etc.) 

Tab 

Toggle COMDEV 

Toggle HARDEV 

Carriage return ) 
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Syntax Meaning 

A\ Rubout 

A$ Escape or Alternate Mode 
AN CTRL A (caret or up-arrow) 
(%) Reserved for future symbols. 
%% % (Reserved). 


The following symbols are no longer recognized. Use the new syntax 
version instead. 


Old New 
Syntax Syntax Meaning 
| <PRINT> Printer on/off 
# <ECHO> User console echoing on/off 
SR <RUBOUT> Rubout 
$C < *CONTINUED Continue to next line 
$ LOGOUT Stop Execute file 


<*> 
<*COMMENT LINE ENDING IN CARRIAGE RETURN 


Comments are not executed or printed. Commands in an EXECUTE file 
which begin with an * are printed but not executed. * may be used to issue 
prompts or explanations. 


Input is taken from the EXECUTE file until: 


e The end of a non-nested file is reached; input is accepted on the 
COMDEV or on any attached CADDS device with a usable keyboard. 


e Another EXECUTE command designating a second file is encountered 
in the file. The contents of the files will be nested such that input 
comes from the second file: when finished, execution of the first file 
resumes where it left off. Any number of files may be nested within 
each other. | 


e The task is terminated (i.e., by a LOGOUT command within the 
Execute file, by stopping CPU, or by TASKILL.) 


Terminating an 
EXECUTE File 
(Continued) 
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e A break character is typed and recognized on the command device. 
There are several special cases: 


— The ESCAPE key causes the task to pause after the next line is 
typed, and remain paused until another key is hit; 


— <ESCAPE> Q terminates the command or printing in progress and 
allows the next command in the Execute file to start immediately; 


— <ESCAPE> N terminates the command in progress and all Execute 
files (including nested ones). | 


— <ESCAPE> K immediately returns to O/S command level. 


CADDS Caution 


ESCAPE-O, ESCAPE-N, or TASKILL (ACAC) 
are not recommended within CADDS because 
they immediately terminate current command 
(CADDS), without filing the active part. 


e CADDS recognizes task-break character (Control-B) after each com- 
mand and within certain long commands such as VERIFY or PLOT. 
Typing CTRL-B usually causes the current CADDS command and 
execution of a file to pause; following CTRL-B with Q aborts both the 
current command and all Execute files. 


e Many CADDS commands including RPNT and ZOOM simply assume a 
Q will be typed and terminate themselves and any Execute files 
immediately. In these cases, it is impossible to resume execution or to 
go to the next command after pausing. A few commands only suppress 
output after recognizing a CTRL-B; they may appear to have paused, 
but both the command and any Execute files will continue to run. 


e The EXECUTE command maintains the characters of the file and nested 
files in a temporary file named SYSEXECUTExxxx (where xxxx is re- 
placed with the task number). Once execution of the file has begun, the 
Original file may be modified or deleted (it may even be deleted by a 
command within itself) without affecting the execution. 


e Since this temporary file must remain in use, the FACLEAR command is 
not allowed within an Execute file. 
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<< THIS FILE SAVES ALL FILES IN 
<*CATALOGS ‘CD3PRTS’ AND ‘DATA’ 


SORTCAT CD3PRTS *<ALPHABETIZE 1ST> 
ATTACH MT, TAPE 

REWIND MT 

< * 

FUTIL 

COPY CD3PRTS,:MT//NLEV 

ADD DATA //NLEV 

<CR><CR> *EXTRA <CR>’S TO COMPLETE SAVE> 
DETACH MT 

* SAVE COMPLETE *PRINT MESSAGE 
<CR> 


(Refer to GENCOM command.) 


EXECUTE 
FILE 
GENCOM CHANGE. TEMP 
< % 
<* INCLUDE THE FOLLOWING THREE HEADER LINES: 
< * 
* THIS EXECUTE FILE CHANGES CALLS FROM ROUTINE ‘MVBYT’ 
* TO ‘MVBYTT’. 
*<CR> 
< * 
<* SPECIFY COMMAND SKELETON: 
< *% 
EDIT $1,-1,-2$ 
S,/MVBYT./,/MVBYTT./<CR>F<CR> 
< * 
<* SPECIFY ALL TEXT FILES IN DESIRED CATALOG(S): 
< * 
WJL//NLEV, TYPE= <CR> 
< * 
<* ALSO INCLUDE THE FOLLOWING THREE TRAILER LINES: 
< * 
* CHANGE COMPLETE !!! 
<* - 
<* SAVE, EXECUTE AND DELETE THIS FILE: 
< * 
<CR>F 
EXECUTE CHANGE.TEMP 
DELETE CHANGE.&BCD.TEMP 
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Sample EXECUTE <* SOME CADDS FILES ARE LINKED: 


Files (Continued) 


Variable Input 


<* 

DELETE DO.&BCD/RELINK 

GENCOM DO.RELINK 

<* EXTRA CARRIAGE RETURN TO 

<* AVOID HEADER LINES: 

<CR> 

LOAD $1,-1,-28<CR> 

CLD//NLEV,TYPE=3 

CLD1000//NLEV, TYPE=3 

CLD2000//NLEV,TYPE=3 

CLD3000//NLEV, TYPE=3 

CLD4000//NLEV,TYPE=3 

CLD5000//NLEV,TYPE=3 

CLD6000//NLEV, TYPE =3 

CLD9000//NLEV,TYPE=3 

CLDFMAKE//NLEV,TYPE=3 

CLDMAKE//NLEV, TYPE=3<CR> <CR> <CR>F 
<* ‘F’ SPECIFIES TO GENCOM 
<* THAT DO.RELINK IS TO BE FILED. 
<* THE EXTRA CARRIAGE RETURNS 
<* CAUSE THE FILE SPECIFICATION 
<* LOOP TO TERMINATE AND TO 
<* AVOID TRAILER LINES IN THE 
<* EXECUTE FILE. 

DATE 

EXECUTE DO.RELINK 

DATE 


lf the characters VAR are encountered by CADDS during the execution of 
a file, CADDS pauses to allow you to type or digitize variable input. Since 


any amount of input is allowed, you must signal the end of your input by 
typing CTRL-X. The file then resumes executing. 


VAR CMD# CADDS gives this prompt before each command when 
entire commands are used as variable input. 


Typical uses of variable input include: a digitize to locate entities, the name 
of a part or subfigure to activate or file, contents of a text string being 
inserted, numerical values for modifiers or machining questions, or PAGE 
and ZOOM commands before plotting a part. 


A comment placed in the file just before the variable input may be used to 
prompt you. | 
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Example of Variable 
Input 


FILCOM 
PURPOSE 


SYNTAX 


COMMENTS 


MESSAGES 
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< % 
<* EXECUTE FILE TO INSERT A BORDER & TITLE BLOCK 
<* FOR A STANDARD SIZED DRAWING 
< * 
*INS STG: * LINES COULD ALSO BE USED 
*BORDER XO YO, X10 YO, X10 Y8, XO Y8, X0 YO;* 
*TITLE BLOCK X7 YO, X7 Y1, X10 Y1; * 
*DIVIDERS IN BLOCK X7 Y.5, X10 Y.5; X8.5 YO, X8.5 Y.5 


<* PROMPT TO OPERATOR: 
* PLEASE TYPE DRAWING NAME & NUMBER, THEN CONTROL-X <BELL> 

<* INS TEXT ‘DRAWING: <VAR>’ HGT .3 FONT 4 CJT: <* X8.5 Y.6 
< * 
<* PROMPT TO OPERATOR: 
<* PLEASE TYPE YOUR NAME, CTRL-X; AND THE DATE, CTRL-X BELL 

INS TEXT “BY: <VAR> ‘DATE: <VAR>” <* 

HGT .2 FONT 1 CJT: X7.75 Y.1, X9.25 Y.1 
< * 


ZOOM WINDOW: X-1 Y-1, X11 Y9 


Compares two binary files. 


FILCOM catalog1.file1,catalog2.file2[/LIST] 


OPTIONS’ LIST Prints a HEXDMP of non-identical sectors in each 


file. 


© The comparison is made word for word, sector by sector. If one file is 
shorter than the other, a message is printed indicating which file ended 


first. 


e When a sector is encountered that is different, a message is printed in- 
dicating sector number and FIRST word that is different. 


FILES IDENTICAL Output when files are identical. 


FILERCVR 


PURPOSE 


SYNTAX 


COMMENTS 


MESSAGES 


FMCHECK 


PURPOSE 


SYNTAX 


FILERCVR 
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Recovers a HARDFILE lost during a system crash. 


FILERCVR Filename 
Where Filename = name of HARDFILE open during system crash. 


Depending on crash, it may be impossible to recover complete HARDFILE 
output. FILERCVR was designed so that it recovers the larger file; it has 
garbage at the end. This is not a bug. The garbage may be removed by 
using the regular text editor. 


HARDFILE RECOVERED Indicates successful completion of 
the command. 


Checks validity of files under file management. 
FMCHECK [catalog] [, NOTCHECK] [,PRNTZERO] [,NOSTAT] 


If catalog is absent, validity check is run on all files; otherwise, it’s run only 
on the files in catalog and all subcatalogs of catalog. 


OPTIONS 


NOTCHECK Outputs the name and new checksum of all type 
 3,4,8, or 9 files that have new checksums com- 
puted for zero CHKSUM words. This message is 

output: 


ZERO CHECKSUM - NEW CHECKSUM GENERATED 
PRNTZERO Outputs names of all zero CHKSUM type files 

along with the message: 

NOT CHECKED - ZERO CHECKSUM (ZERO - CHECKSUM TYPE) 


NOSTAT Suppresses processing output. Allows summary 
output. 
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COMMENTS e FMCHECK is run only on enabled volumes for non-temporary files that 
are not opened for MODIFY and not access-protected. Files must meet 
the following validity criteria: 


— The file must not have zero length. 


— For files not of type 2,3,4,8, or 9, the CHKSUM word of the file 
entry (word 23) must be zero. 


— For type 3,4,5,8,or 9 files, either the CHKSUM word is zero, or the 
CHKSUM of the total file (all full sectors—including any file data, 
but not trailing sectors) equals the CHKSUM word. 


— For type 2 files, either the CHKSUM word is zero and the internal 
object file CHKSUM (word 2) is correct, or the CHKSUM of the 
object file (excluding trailing words in the last sector) equals the 
CHKSUM word. 


e During FMCHECK, violations of the above criteria are printed out along 
with the name of the file in error. File management or system errors 
terminate FMINIT. Error messages are printed along with the name of 
last file processed and final statistics. 


e If a catalog is ACCESS or READ-protected it is not checked; the catalog 
name is output along with the message: 


PROTECTED - NOT CHECKED 


OUTPUT Name of requested catalog and names of first-level subcatalogs are printed 
(unless NOSTAT option used). At FACHECK’s completion, the following 
summary is output. (All statistics = decimal numbers; except Totsect = 
hexadecimal.) 


TOTAL FILES PROCESSED: Total 


FILES CHECKSUMED CORRECTLY: 
Checked, 
FILES IN ERROR: Errcnt 


FILES WITH ZERO CHECKSUMS: 
Unchecked, 

FILES WITH ACCESS ERRORS: 
Fmerrcnt 


FILES WITH NEW CHECKSUMS 
GENERATED: Gendsums 
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TOTAL SECTORS USED BY 
CATALOGS: Totsect 


Total Number of non-catalog files on which validity check 
was run. 

Checked Number of files CHKSUM’ed with no violation found. 

Errcnt Number of files with validity errors. 

Unchecked Number of files of zero checksum type not in error. 

Fmerrcnt Number of files on which file manager access errors 
occurred. 


Gendsums Number of files of checked type with new checksums 
. generated for previous zero checksums. 


Totsect Total sectors used by catalog hexadecimal. 


ESCAPE O terminates FMCHECK and outputs the last file checked along 
with a summary of the file checked to that point. 


Closes any open files in file management (FM) file structure. 
FMCLEAR [Catalog] [ /{[Filelist] [/Options] }] 


Filelist = list of subcatalogs and/or filenames within specified Catalog. To 
clear SYSCATLG, SYSCATLG must be input on the command line as the 
catalog level. | , 


OPTIONS NOLIST Suppresses certain messages resulting from 
clearing of file/catalog entries. (See VESSAGES 
at the end of this section.) NOLIST responds 
with its own message In only one circumstance: 
TEMPORARY FILE DELETED 


or 


TEMPORARY FILE RENAMED TO: 


This is output if the new version of a file, opened 
for create with supersede, is deleted or renamed. 
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COMMENTS 


SINGLE USER 
MODE ONLY 


Boot-Up 
FMCLEAR 


FMCLEAR 
SYSCATLG or 
FMCLEAR 
SYSCATLG// 
Options 


MULTI-USER OR 
SINGLE USER 
MODE 
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FMCLEAR sets use count to zero; clears file status word and left byte of 
protection word in all files marked in use in file structure. 


Whenever control passes back to the system command level, the 
system automatically closes any open files, as indicated by entries in the 
FM channels (i.e., unclosed channels). 


FMCLEAR is run at bootup time to clear any files left open as a result of 
a reboot or SAVCOR operation where the system was not able to close 
opened files before the system reboot. FMCLEAR can also be run at any 
other time to clear files which have been left open as a result of anincon- | 
sistency in either disc file structures or FM channel data structures. 


FMCLEAR is illegal in an EXECUTE file or when there is an open HARD- 
FILE. 


All other users must be off system; files open on FM channels are cleared 
with no prior check made. When a name is specified, the FMCLEAR 
method is different. 


Automatically run when first user logs in. It looks at the FM channels to 
determine what files to clear. Volume entries are also cleared at that time. 


Searches entire catalog structure, including any enabled volumes, for files 
to be cleared. Only one user may be logged in (time consuming search for 
large file structures); if other users are logged in, additional checks would 
have to be made to determine if the file is opened on a channel. 


FMCLEAR with a FM Name list searches the specified calalog structures 
on disc for files to be cleared. 


For the following method of FMCLEAR, other users may be on the system. 
Individual catalogs or files may be cleared with other users on the system; 
FM checks to see if files are opened on channels. 


FMCLEAR Wholecatalog ) 
Clears all levels of catalog Wholecatalog. 
FMCLEAR Mycatalog/File1,File2 Subcatalog1, File3 } 


Clears Mycatalog.File1, Mycatalog.File2, Mycatalog.File3. It will clear 
Mycatalog.Subcatalog/ for all levels. 


- MESSAGES 
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RENAMING 


New temporary files, opened for create with supersede, may be preserved 


by a renaming operation. 


CATALOG.FILENAME 


ENTER NEW LAST LEVEL 
NAME FOR TEMPORARY FILE 


TEMPORARY FILE 
RENAMED TO: 
CATALOG.NEWNAME 


TEMPORARY FILE DELETED 


CATALOG.FILENAME 
ORIGINAL FILE CLEARED 


CATALOG.CATALOG or FILENAME 
FILE CLEARED — or — 
CATALOG CLEARED 


CATALOG.FILE 
WORKFILE DELETED 


CATALOG.FILE 
WORKFILE DELETED 


FILE MARKED FOR DELETION: 
FILE DELETED 


This message is output when a file is 
is marked open for create with 
supersede. Input new filename 
(single name, max. 20 characters). 
Filename is checked in CATALOG for 
uniqueness. 


An error message (followed by a 
prompt) indicates that the new 
filename is not unique. Provide a dif- 
ferent filename, or delete the new, 
temporary file: 


The new (or newly revised) filename 
is unique; the new, temporary file is 
given same file type as the original. 


Output when ) is used to delete the 
new file. 


In either case, the original file is pre- 
served and cleared with this 
message. 


Output for every cleared file or cata- 
log. May be suppressed; see 
NOLIST. 


Results when original version of a file 
is opened for create or supersede. 
May be suppressed; see NOLIST. 


File of type ‘FF’ hex (also known as a 
WORKFILE) is unconditionally 
deleted. May be suppressed; see 
NOLIST. 


Marks, for deletion, an original file 
simutaneously open for read and for 
supersede, when supersede finishes 
before read. File is not deleted until 
open for read is done. Files of this 
status are always unconditionally 
deleted with this message. May be 
suppressed by NOLIST. 
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FORTXREF 
PURPOSE 
SYNTAX 


NOTE 


FPHEX 
PURPOSE 


SYNTAX 


COMMENT 
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Produces a full cross-referenced listing of a FORTRAN source program. 
FORTXREF catalog.file 


See the CGOS 200 GNA Programmer Reference Manual for additional in- 
formation. 


Converts a floating point number to its hexadecimal equivalent. 
FPHEX floating point number 


Floating point number = character representation of a floating point 
number, including numerics, minus sign, and decimal point. 


FPHEX outputs a two-word hexadecimal representation of the number and 
returns control to the O/S. 


FUTIL 


PURPOSE 


SYNTAX 


FUTIL 
Subcommands 
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A device-independent file utility that provides facilities for copying, 
deleting, printing, and listing files. FUTIL is a multi-function O/S level 
command that has various internal commands (subcommands) for specific 


utility functions. 


FUTIL ) 


COMMAND [SOURCE] [DESTINATION] } 


COMMAND [SOURCE] [DESTINATION] })...... 


quit) 
COMMAND 
SOURCE 
DESTINATION 


QUIT 


Any FUTIL subcommand, listed below. 
Source of the files to be processed. 
Destination of the files to be processed. 


Exits FUTIL to return to O/S level. 


Command syntax will be described in depth. 


Unless indicated, these commands are recognized in FUTIL and also at 
O/S command level. 


ADD 


ADDTEXT 


CHECK 


CONVERT 


Appends file manager files to magnetic tape file being 
created. ADD is not recognized as a command at O/S 
command level. 


Performs ADD for text files only. ADDTEXT is not 
recognized as a command at O/S command level. 


Checks magnetic tape files against the original disc 
versions. 


Copies/converts special format magnetic tape files and 
character sets (works on text files only). 
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(Continued) 
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CONVERTB 


COPY 
COPYTEXT 
DELETE 
LIST 
LISTLP 
LISTTEXT 
MOVE 
PRINT 
PRINTLP 


QUIT 


Examples 


Copies/converts special format magnetic tape file (used 
for binary file conversion only). 


Copies files. 

Copies text files. 

Deletes disc files. 

Lists catalog and file information. 

Lists catalog and file information on HARDEV only. 
Lists text catalog and file information. 

Copies files, deletes originals. 

Prints text files. 

Prints text files on HARDEV only. 


Exits FUTIL internal command level and returns to O/S 
command level!. 


The most common FUTIL operations are: 


COPYING disc files. 


— SAVING files on magnetic tape. 
— RESTORING files from magnetic tape. 


PRINTING text files. 


FUTIL 


Subcommands 
(Continued) 


COPYING DISC 


FILES 
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Examples of all of these operations are presented here. All examples are 


based on the following sample file structure: 


Note 


FILENAME DATE TIME TYPE 
CAT1.&BCD.SUBCAT2 03/05/80 11:44:29 03 [text] 
CAT1.SUBCAT1.&BCD.FILE1 01/03/80 13:24:27 03 [text] 
CAT1.SUBCAT1.&BCD.FILE2 11/14/79 09:22:13 03 [text] 
CAT1.SUBCAT1.&BCD.FILE3 05/23/80 12:53:04 03 [text] 
CAT1.SUBCAT1.&BCD 11/14/79 09:22:12 01 [catalog] 
CAT1.SUBCAT1.FILE1 01/03/80 14:15:33 02 [object] 
CAT1.SUBCAT1.FILE2 05/24/80 15:30:22 02 [object] 
CAT1.SUBCAT1.FILE3 05/23/80 13:15:52 02 [object] 
CAT1.SUBCAT1.SUBSUBCAT.&BCD.FILE 08/08/80 14:14:14 03 [text] 
CAT1.SUBCAT1.SUBSUBCAT.FILE 08/08/80 14:14:16 02 [object] 
CAT1.SUBCAT1.SUBSUBCAT 08/08/80 14:14:12 01 [catalog] 
CAT1.SUBCAT1 05/22/79 17:49:32 01 [catalog] 
CAT1.SUBCAT2.&BCD.FILE 12/29/79 10:21:02 03 [text] 
CAT1.SUBCAT2.&BCD 12/29/79 10:20:59 01 [catalog] 
CAT1.SUBCAT2 12/29/79 10:20:58 01 [catalog] 
CAT1 11/13/78 18:03:46 01 [catalog] 
CAT2.SUBCAT1.FILE1 03/17/79 10:53:15 20 = [part] 
CAT2.SUBCAT1.FILE2 03/17/79 10:53:25 21 = [part] 
CAT2.SUBCAT1.FILE3 03/17/79 10:53:33 22 = [part] 
CAT2.SUBCAT2.FILE 09/23/80 18:35:20 [temp] 


You can produce a similar listing of any 
portion of your own file structure with the 
FUTIL LIST command: 


LIST/LIST =DT CATALOG 


Copying disc files is the easiest and most common FUTIL operation. These 
representative examples are based on the file structure described above: 


COPY CAT1 CAT3 


Copies everything in the primary catalog CAT1 to a new catalog 
CAT3. For example, the file CAT1.SUBCAT1.FILE1 is copied to a 
new file CAT3.SUBCAT1.FILE1. None of the original files in CAT1 are 
changed. 


COPY CAT1.SUBCAT1 CAT3 


Copies everything in the subcatalog SUBCAT1 of CAT1 into a new 
catalog CAT3. The subcatalog SUBCAT1 is not part of the new 
name. For example, the file CAT1.SUBCAT1. FILE1 is copied to a 
new file CAT3.FILE1. None of the original files in CAT1.SUBCAT1 are 
changed. 
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COPYING DISC COPY CAT1.SUBCAT1//LEVEL=1 CAT3.SUBCAT1 


FILES (Continued) Copies only those files in the first level of subcatalog SUBCAT1 in 


CAT1. These files are copied to CAT3.SUBCAT1. The files copied 
are: 


CAT1.SUBCAT1.FILE1 => CAT3.SUBCAT1.FILE1 
CAT1.SUBCAT1.FILE2 => CAT3.SUBCAT1.FILE2 
CAT1.SUBCAT1.FILE3 => CAT3.SUBCAT1.FILE3 


IV IV 


COPY CAT1.SUBCAT1.FILE1> CAT3.SUBCAT2.FILE2 
Copies only the specified file. 


Note 


The > symbol is an optional way to separate 
source and destination fields. This command 
is the same as: 


COPY CAT.SUBCAT1.FILE1 CAT3.SUBCAT2.FILE1 


COPY CAT1/FILE1/LEVEL=N CAT3 


Copies all files in CAT1 that have names ending with FILE1. Files 
copied are: 


CAT1.SUBCAT1.&BCD.FILE1 
CAT1.SUBCAT1.FILE1 


COPY CAT1.SUBCAT1/&BCD.FILE1,FILE2> CAT3 
Copies particular files in CAT1.SUBCAT1. These files are: 


CAT1.SUBCAT1.&BCD.FILE1 
CAT1.SUBCAT1.FILE2 


~ COPY CAT1//TYPE=3 CAT3 
COPY CAT1//TYPE= TEXT CAT3 


Both of these commands do the same thing. All of the text (type 3) 
files in CAT1 are copied. These files are: 


CAT1.&BCD.SUBCAT2 
CAT1.SUBCAT1.&BCD.FILE1 
CAT1.SUBCAT1.&BCD.FILE2 
CAT1.SUBCAT1.&BCD.FILE3 
CAT1.SUBCAT1.SUBSUBCAT.&BCD.FILE 
CAT1.SUBCAT.&BCD.FILE 


3-84 


FUTIL 


The information and drawings contained herein are the sole property of Computervision 
Corporation. Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
express written consent of Computervision. 


COPYING DISC 
FILES (Continued) 


SAVING FILES 


RESTORING FILES 


COPYTEXT CAT1.SUBCAT2 CAT3.SUBCAT2 
Copies the following text files: 


CAT1.&BCD,SUBCAT2 
CAT1.SUBCAT2.&BCD.FILE 


FUTIL is frequently used to create backup tapes. This section contains 
examples of common commands and sequences of commands for backing 
up files on tape. After files are written to tape, use CHECK to validate tape 
files against their originals. 


COPY CAT1 :MT1//LABEL = ““VOLSER”’, CHECK 


Places all CAT1 files onto the first file of a stacked tape. The first 

~ record of the tape must be a VOL1 label. After all files have been 
saved, a check pass is run to validate the data. Files retain their 
original names when written to tape. 


FUTIL 

COPY CAT1>:MT1//LABEL = “VOLSER”’,CHECK 
ADD CAT2 

QUIT 


Saves the entire contents of CAT1 on tape, performs a check pass, 
and then saves files in CAT2. Runs check pass on appended CAT2 
files, since CHECK remains in effect for all successive ADDs. 


COPY CAT1> :MT1.CAT3//LABEL = ‘‘VOLSER”’’, CHECK 


Identical to the first example in this section, except that the CAT1 por- 
tion of each filename is changed to CAT3 when the file is written to 
tape. A check pass is the final step. 


FUTIL 

COPY CAT1 :MT1.CAT3//LABEL = ““VOLSER”,CHECK 
ADD CAT2 CAT4 

QUIT 


Identical to the second example in this section except that CAT1 por- 
tion of filenames is changed to CAT3, and CAT2 portion of filenames 
is changed to CAT4. 


Sample commands for restoring files that have been backed up on 
magnetic tape: 


COPY :MT1 


Restores all files contained in the first file of a stacked tape. The files 
are restored with the names they have on tape. 
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RESTORING FILES COPY :MT1.CAT1 CAT3_ 


(Continued) 


PRINTING TEXT 
FILES 


FUNCTIONAL 
OVERVIEW 
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Restores all files on tape that have an initial catalog name of CAT1. 
Files are restored with the CAT1 portion of the name changed to 
CATS. 


This section contains examples of the PRINT and PRINTLP commands. 


PRINT CAT1.SUBCAT1//LEVEL = 1 


Prints the following files on the COMDEV (terminal). The files are 
printed with the filename and a date heading, but no line numbers. 


CAT1.SUBCAT1.&BCD.FILE1 
CAT1.SUBCAT1.&BCD.FILE2 
CAT1.SUBCAT1.&BCD.FILE3 


PRINT/DIGITS =6 CAT1.SUBCAT1//LEVEL=1 
Identical to the previous example, except that files are now printed 
with line numbers. 


PRINTLP CAT1.SUBCAT1//LEVEL = 1 


Identical to the preceding command, except that files are printed on 
the line printer. Line numbers are printed for each file and each file has 
the filename and date as a header. | 


PRINTLP CAT1.SUBCAT2.FILE 


Prints one file on the line printer. 
CAT1.SUBCAT2.&BCD.FILE 


This section is a functional overview of FUTIL documentation. 


Most FUTIL commands can be used in either of two modes: the external 
mode or the internal mode. The internal mode is reached by typing FUTIL 
in response to the O/S prompt (n>); enter FUTIL commands in response 
to the (#) prompt. 


Standard command syntax is identical for internal and external modes. It 
has three components: Command field, Source field, and Destination 
field. 


¢ Command field is mandatory, it identifies the command. Source and 
Destination fields are optional for some commands. 


¢ Source field identifies input. 
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e Destination field directs output. 
e Source and destination fields, include any of the following elements: 
— Devices 
— Tape record numbers 
— Catalogs 
— Filenames 
e Each of the three fields accepts options. 
Exceptions to standard command syntax include: 
e Syntax errors (FUTIL allows for correction) 


e Multiple line commands 


FUTIL commands: 


Normal commands Text commands 
ADD ADDTEXT 
CHECK CONVERT ——— \ MICARDS 
CONVERTB \ IPC 
COPY COPYTEXT \ EIAIN 
DELETE LISTTEXT \ EIAOUT 
LIST PRINT 
LISTLP PRINTLP 
MOVE 
QUIT 


For added flexibility in command use, FUTIL supports various options. 
There is an Optionlist associated with each component of the standard 
command syntax. In the following chart, Optionlists are as follows 
(abbreviations in parentheses): Command field (C), Source field (S), and 
Destination field (D). 
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File spec options Conversion options 
BEFORE (S) CONVERT 
EXCEPT (S) /BLKSIZ 
LEVEL (S) FORMAT— — —RECCNT 
NLEV (S) \ RECSIZ 
SINCE (S) ~LASTBLK 
SUBCAT (S) LBLS 
TYPE (S) LEADCHAR 
| LEADER 
List command options Magnetic tape options 
ALL (C) CHECK 
DLOC (C) COLD 
FULL (C) LABEL 
LABELS (C) NOCHECK 
LIST (C) OVERLAST 
SYSTEM (C) RSTFIL 
TEMPFILS (C) SAVEFIL 
USER (C) TAPEFILE 
USERLBLS 
Printing options Miscellaneous options 
COPIES (C,D) ARCHIVE 
DIGITS (C,D) ASK 
FILEHEAD (C,D) CHECKSUM 
LENGTH (C,D) DISKPOS 
LINES (C,D) DRWUPDAT 
MARGIN (C,D) LIST 
PAGENUMS  (C,D) NEWCHAR 
WIDTH (C,D) NEWDATE 
: NOARCHIVE 
NOPROTECT 
NOSHIFT 
OLDDATE 
PROTECT 
RELACE 
SHIFT 
SRCHLIM 


(C) 
(S,D) 


(D) 
(S,D) 
(D) 
(D) 


(D) 
(S,D) 
(D) 
(D) 
(D) 
(S,D) 
(S,D) 
(S,D) 
(D) 


(C) 
(S) 
(S) 
(D) 
(C) 
(C) 
(D) 
(D) 
(C) 
(D) 
(D) 
(D) 
(D) 
(D) 
(D) 
(S) 
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Note 


Any FUTIL option may be used in either the 
Source, Destination, or Command fields 
without generating an error. To avoid possible 
ambiguities, however, use Options in the fields 
specified above. 


The FUTIL-O/S_ interface sometimes produces unusual results, 
particularly in the following areas: 


Response to system toggles 
Working directories 

Interrupt handling 

Error handling 

Execute file handling 

llegal characters in filenames 


FUTIL supports several formats for creating system disc file back-up tapes. 
Tape label and data formats must conform to certain conventions: 


e Data formats 


— Blocked tape formats 
— FUTIL format tapes 
— SAVFIL/RSTFIL format tapes 


e Tape labels 


— Label groups 
— Files — file sections — file sets 
— Required labels 


FUTIL has two modes of command execution: 


— Commands within FUTIL 
— FUTIL O/S commands 


Typing FUTIL in response to the O/S command prompt (n >FUTIL), 
activates the internal command execution mode. FUTIL then prompts for 
commands (#). Commands and errors are then handled without returning 
to O/S level. Typing QUIT, in response to the FUTIL prompt, returns you 
to O/S command level. 
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Commands Within 
FUTIL (Continued) 


FUTIL O/S 
Commands 


Command Syntax 


Command 
Components 
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FUTIL commands are listed below. Forma! abbreviations, (in parentheses), 
can be entered in internal command mode, as a response to the (#) 
prompt. 


ADD | (A) DELETE (D) 
ADDTEXT (AT) LIST (L) 
CHECK LISTTEXT (LT) 
CONVERT LISTLP (LL) 
CONVERTB MOVE (M) 
COPY (C) PRINT (P) 
COPYTEXT (CT) PRINTLP (PL) 
QUIT (QU) 


The internal command mode has these advantages: 


Faster execution of commands 

Use of abbreviated commands 

Exclusive use of certain commands 

Ability to append new files or continue to search for files on a reel of 
tape without rewinding the tape for each new command 


The standard FUTIL internal commands, except for ADD, ADDTEXT, and 
QUIT, are available outside of FUTIL as identical O/S commands. They are 
entered in response to the O/S command prompt, (n> Command), 
without first entering FUTIL. In this case, FUTIL returns directly to O/S 
level upon completion of the command or detection of an error. 


FUTIL O/S level commands cannot be renamed or cross-referenced with a 
SYSCMTB or USERCMTB. O/S level commands cannot be abbreviated. 


FUTIL has a standard command syntax with three components: 
¢ Command — 
e Source File Specification 
e Destination File Specification 


The fields are combined in this sequence: 


Command [Source [> Destination]] 


Command 
Components 
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e Spaces may be used freely, except in the following cases: 


— There must be a space separating the Command field from the 
Source and the Destination fields. 


— There can be no space between a Command name and the slash 
denoting the Command Optionlist (if specified). 


— Names, including full filenames, cannot contain any spaces. 


— There must be either a greater-than sign (>), or one or more spaces 
between Source and Destination fields. 


® Command is mandatory; Source and Destination are optional, depend- 
ing upon the Command. 


— If Source or Destination is omitted, ://LEVEL=N is the assumed 
default. 


— If the Destination is specified, there must be a Source specification. 


— Omitting Source or Destination may yield undesired effects. To 
avoid problems, state the Source and Destination fields explicitly. 


The three command components are further subdivided. In command 
syntax, the subdivided elements are separated by slashes (/): 


Command = Commandl[/Optionlist] 
Source = [Catalog][/Filenamelist][/Optionlist] 
Destination = [Catalog][/Optionlist] 


e The Command portion consists of the Command name and optional 
Optionlist. 


e Source consists of three elements, and Destination consists of Catalog 
and Optionlist: 


— Catalog Includes the device and primary catalog name. 
— Filenamelist List of filenames (Source only). 
— Optionlist Another list of options. 


Options and Optionlists 


Most options can be used in any Optionlist without generating an error. 
However, some options have unpredictable effects if used in an inap- 
propriate Optionlist. Both the Overview options chart and descriptions 
show the Optionlist(s) associated with each option. To avoid problems, 
use an option in the appropriate list. 
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Command The three Optionlists are: 
Components 7 
(Continued) ¢ The Command Optionlist — options not related to Source or Destina- 


tion fields and options specifically related to command function. 


e The Source Optionlist — options related to the Source device and file 
specifications. 


e The Destination Optionlist — options related to the Destination 
device and files. 


Field/ Element Meaning and Use 

CATALOG Specifies either a device, or a catalog or filename, or 
| both. 

COMMAND Basic FUTIL function. 


DESTINATION Destination of files to be processed. This field may con- 
tain a catalog name or device ID. 


FILENAMELIST List of one or more filenames separated by comma 
(e.g., COMMAND.FUTIL, COMMAND.&BCD.FUTIL). 


OPTIONLIST List of options separated by commas (e.g., 
NLEV,REPLACE= YES). 
SOURCE Source of the files to be processed. This field may 


contain a catalog name, device ID, or filename (e.g., 
SYSNEWS, SYSNEWS.LCLNEWS, :MT1, 
-MT1. SYSNEWS). 


Catalogs In FUTIL syntax, the device name is specified as part of the catalog. The 
catalog may have the full name of a single file in standard system filename 
format. When not specified, SYSCATLG is implied. The catalog name is 
illegal unless the device specified supports named fields. 


This is the Catalog syntax: 
e If both a device and a catalog(or filename) are used, the device must 
be joined to the rest of the catalog/filename by a dot (.), as in 


device.catalog 


e Primary disc is the default device. It can also be specified by a colon 
(:) without a taskunitname. | 
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e Any device specification must be the first Catalog level (prior to the 
site ID, volume name, and primary catalog or filename). 


e If a device specification is not allowed within a particular Source or 
Destination field, a colon may be still be used. In this case, the colon is 
merely a place holder. For example, the ADD command does not 
allow a device in the Destination. The following command, however, 
is still valid. 


ADD catalog: 


FILE 

CATALOG.SUBCATALOG.FILE 

[1]. CATALOG.SUBCATALOG.FILE 
[1].*VOLUME.CATALOG.FILE 
-MT1.CATALOG.SUBCATALOG.FILE 
: FILE 

:-LP 


The device is the physical unit where files are stored. Files are assumed to 
be on disc, unless the command or options imply otherwise. 


The device element of the Source and Destination fields is specified as 
follows: 


‘XYIin] 
XY Can be either: 


— A taskunitname; the two-character name of a device 
attached to the task. 


— A generic device type; a two-letter symbol indicating the 
type of device. In this case, the first device specified and 
attached to the task is used. 


n The exact file number (position on the tape) of the tape file to 
be processed. If n is used, the XY device must be a magnetic 
tape unit. 


— If nis not specified or n = 0, the first tape file on the reel 
is implied. A tape rewind is always implied. 
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Devices — Ifn = 1, the first tape file is also implied. This differs from 

(Continued) n = Oin the case of a multi-reel file. (When n = 1, an error 
results unless the first reel is mounted; when n = 0, the 
first file on the reel is read, regardless of which reel is 
mounted.) A tape rewind is always implied by n = 1. 


— Ifn = -1, the last tape file on the reel is implied. 


Note 


A tape file is not the same as a file manager 
file. A single tape file may contain many file 
manager files. File manager files are the nor- 
mal, named system (disc) files. Tape files are 
numbered with respect to a particular reel of 
tape. 


GENERIC DEVICE MT = Magnetic tape drive (Source or DEVICE Destination) 
TYPES 


LP = HARDEV (Destination). The only device that need not be 
attached to the task. The system default HARDEV is automat- 
ically attached when :LP is specified and there is no task 
HARDEV. When LP is Speen the Destination catalog name is 
not allowed. 

CM = Task COMDEV (Destination). The Destination catalog element is 
not allowed. 

PT = PPTDEV (Destination). RPTDEV (Source). A catalog name is not 
allowed with this device. 

CD = Card reader (Source). A catalog name is not allowed with this 
device. 

TAPE RECORD | When the Source device is a magnetic tape unit,the Record Number List 
NUMBERS (or Numberlist) may be used in place of the catalog name. This feature is 


available only for standard FUTIL format tape files and _ older 
SAVFIL/RSTFIL format tapes. The Numberlist is a series of numbers and 
number ranges enclosed in parentheses. (Each File Manager file saved on 
tape has a sequence number that indicates its position in the main tape file. 
The only way to identify a sequence number of a particular file is to use the 
LIST or LISTTEXT commands to list the tape file in question.) The 
Filenamelist field must be empty when the Numberlist is used. A dot (.) 
must separate this Numberlist from the device. 
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The format of the Numberlist specification ts: 
(n1[-n2][,n3[-n4][,...]]) 


Example of a Source specification: 
*>MT1.(4-5,8,20-22,30) 


Sequence numbers of specified files: 
4,5, 8, 20, 21, 22, 30 


In a Source field, the catalog may be a filename. In this case, the Destina- 
tion catalog is also assumed to be a filename and only one file is processed. 
The Filenamelist must be empty. 


Examples: LIST CAT2.SUBCAT2.FILE//LIST =SP 

PRINTLP CAT1.SUBCAT2.FILE//DIGITS =6 
FILENAME When copying files from one place to another FUTIL 
CHANGES often renames the copied files. The catalog element (of 


both the Source and Destination fields) determines the 
new base catalog name. 


e Name changes involve only that part of the full filename that matches 
the Source Catalog. 


e The device is not considered part of the modified portion of the 
filename. 


e In the transfer from Source to Destination, filenames are processed in 
one of five ways: 


1. No change; the filename is copied unchanged. The Destination 
device may differ from the Source device, but the actual name of 
the file is not modified. The filename will not be modified if the 
Destination catalog is blank; or if only a device is specified, with no 
period following it, in the Destination catalog. 


FILE = => FILE 


COPY :MT 

COPY :MT: 

COPY : :MT 

COPY :MT1.FILE 
COPY :MT1.FILE FILE 
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Filenames 2. Complete change; the catalog name is changed entirely from 
(Continued) Source to Destination. This catalog is accomplished by specifying a 
7 7 catalog name in both the Source and Destination catalogs. 


CATALOGA.FILE = => CATALOGB.FILE 


COPY CATALOGA CATALOGB 
COPY :MT.CATALOGA CATALOGB 
COPY :.CATALOGA :MT2.CATALOGB 


3. Prefixing; the primary Destination catalog name is attached to the 
front of the primary catalog name of the Source. Add a prefix by 
specifying an ! after the catalog name in the Destination. 


CATALOGA.FILE = = > CATALOGB.CATALOGA.FILE 


COPY CATALOGA CATALOGB:! 
COPY CATALOGA :MT1.CATALOGB.! 
COPY :MT1.CATALOGA CATALOGB.! 


4. Suffixing; the primary Destination catalog name is attached to the 
end of the primary Source catalog name. Add a suffix by specifying 
an ! after the device and before the catalog name in the Destination 
catalog. 


CATALOGA.FILE = = > CATALOGA.CATALOGB.FILE 


COPY CATALOGA !.CATALOGB 
COPY CATALOGA :MT1.!.CATALOGB 
COPY :MT2.CATALOGA !.CATALOGB 


5. Stripping; the primary Source catalog name is removed from the 
full name of the Destination file. Strip the Source catalog name by 
specifying a device followed by a period, but not a catalog name, in 
the Destination catalog. 


CATALOGA.FILE = => FILE 


COPY CATALOGA :. 
COPY :MT1.CATALOGA :. 
COPY CATALOGA :MT1. 


Filenamelist The Filenamelist is used to identify the names of files in the base catalog 
| specified (or implied) in the Source field. Each name in the field may con- 
sist of several catalog levels. Names in the list are separated by commas 
(,). Wild cards may be used in the Filenamelist to replace characters in the 
filename. The SUBCAT and EXCEPT options modify the search for files 
named in the Filenamelist. 
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Three characters allow you to substitute for any character or catalog level 
in the filename. With these characters, all files matching the rest of the 
filename can be included in the Filenamelist 


Wildcard 


? 


?\ 


1\ 


Examples 


Specification 


CAT?EVEL 
FIL?2? AME 


F?LENA?E 


FILE? \ 
CAT? \ LOG 


?\ LENA? \ 


Description 


Substitutes for any alphanumeric character in a 
filename. With two or more ?’s, two or more characters 
in the same positions will produce a match. A ? cannot 
replace the dot (.) used as a catalog level name 
separator. 


Like ? but substitues 0 to n characters. If ? \ is the only 
specification for a catalog level, the catalog level may be 
omitted from the matched name. 


Substitutes a full catalog level name. The catalog level 
must contain one character to result in a match. When 
more than one ! is used, separate catalog from non- 
wildcard levels by the usual dot (.). 


Substitutes 0 to n full catalog levels. 


Possible Filenames 


CATLEVEL 
CAT-EVEL 
CAT6EVEL 


_ FILENAME 
FIL5B6AME 
FIL-2AME 


FILENAME 
FILENA-E 


FILE 
FILE1 
FILE123-0 


CATLOG 
CATABCDLOG 
CAT5LOG 


LENA 
FILENAME 
CATALENA 
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Wild Cards 
(Continued) 


Examples 
Specification 


CAT.!.G 


CAT.!.G 
CAT.C1.! 


CAT.!\ .G 
CAT.!\ 


- CAT.CAT?.FILE 
CAT.?. FILE 


CAT.?\ .FILE 
CAT.!.?\ .FILE 


CAT.!\.?\.FILE 


File Searching 


Possible Filenames 


CAT.CAT1.G 
CAT.A.G 
CAT.&BCD.G 


CAT.A.B.G 
CAT.Q.&BCD.G 


CAT.C1.FILE 
CAT.C1.XX 


CAT.G 
CAT.&BCD.G 
CAT.A.B.C.D.G 


CAT 
CAT.FILE 
CAT.&BCD.QQQ 


CAT.CATX.FILE 
CAT.CAT1.FILE 


CAT.R.FILE 
CAT.A.FILE 


CAT.FILE 
CAT.&BCD.FILE 
CAT.A.FILE 


CAT.X.FILE 
CAT.X.&BCD.FILE 
CAT.Q.A.FILE 


CAT.FILE 
CAT.A.FILE 
CAT.&BCD.FILE 
CAT.A.&BCD.FILE 
CAT.A.B.C.FILE 


Use the LEVEL option to control file searches: 


e If the filenamelist is empty, FUTIL defaults to a complete traversal of 
the primary catalog. This is equivalent to specifying LEVEL=N or 


NLEV. 


e With names in the filenamelist, the default is a LEVEL=O search of 
the primary catalog. 
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e Use the LEVEL option (LEVEL=n) to control the depth of the search, 
e.g., to search only a single level of the primary catalog when the 
filenamelist is blank, or to search multiple levels when there are 
names in the filenamelist. 


e The SUBCAT option enables a search of up to n levels beyond the 
subcatalog names specified in the Filenamelist. 


Examples 
In the following examples a ! stands for an arbitrary catalog name. 


CATALOG 
CATALOG//LEVEL=N returns: 


CATALOG 
CATALOG:|! 
CATALOG.!.! 
CATALOG.!.I.NEE! 
etc. 


CATALOG/NAME 
CATALOG/NAME/LEVEL=WN returns: 


CATALOG.NAME 
CATALOG.!.NAME 


etc. 


CATALOG//LEVEL=0 returns only: 
CATALOG 


CATALOG/NAME/LEVEL=0 returns only: 
CATALOG.NAME 


CATALOG//LEVEL =1 returns: 


CATALOG 
CATALOG:! 


CATALOG/NAME/LEVEL = 1 returns: 


CATALOG.NAME 
CATALOG.!.NAME 
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CATALOG/NAME/LEVEL = 3 returns: 


CATALOG.NAME 
CATALOG.!.NAME 


CATALOG/SUBCATALOG/SUBCAT 
—or— | 
CATALOG/SUBCATALOG/LEVEL=N,SUBCAT returns: 


CATALOG.SUBCATALOG 
CATALOG.SUBCATALOG.|! 


etc. 


CATALOG/SUBCATALOG/LEVEL =0,SUBCAT returns: 
CATALOG.SUBCATALOG 


CATALOG/SUBCATALOG/LEVEL = 1,SUBCAT returns: 


CATALOG.SUBCATALOG 
CATALOG.SUBCATALOG.|! 


CATALOG.SUBCATALOG/LEVEL =3,SUBCAT returns: 


CATALOG.SUBCATALOG 
CATALOG.SUBCATALOG:! 
CATALOG.SUBCATALOG.!.! 


FUTIL provides for correction of syntax errors caused by typing errors. An 
up-arrow (A ) points to the punctuation at the start of the incorrect syntax 
element; appropriate error messages are printed. FUTIL prompts for 
correction with an angle-bracket(>) followed by the portion of the line 
accepted as correct; FUTIL does not type the incorrect part of the line. The 
segment accepted and retyped by FUTIL cannot be erased or typed over. 
Continuing the line with } aborts the command. Any other response, 
including a space, is assumed to be a correction and continuation. 
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Multiple Line Long, complex FUTIL commands may extend over more than one physical 
Commands line (80 characters). These commands can only be broken up immediately 
after a syntax element (see list), or between element punctuation. Certain 
punctuation, such as commas (,), must occur on the new line, not the old. 


Commands may be continued after these syntax elements: 


Command (name) 

Source 

Destination 

Filenamelist 

Optionlist 

Any complete filename in a Filenamelist 
Any complete option in an Optionlist 


A semicolon (;) at the end of the current line indicates that the next line is a 
continuation of the same command. After FUTIL is processes the line up 
to the continuation, an angle-bracket (>) prompts for the continuation 
line. Separator punctuation following the break (except for required 
spaces) must begin on the new line. 


Note 


A limited number of file and catalog names are 
allowed on a FUTIL command line. If this limit 
is exceeded, an error results — additional 
filenames are not allowed. 


Blanks or spaces may be used freely where continuation breaks are 
allowed. There must be at least one blank or continuation break between 
the Command field and the rest of the command, and one between the 
Source and Destination fields. 
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A keyword is a Command or option name, or a_ non-literal 
option value. Command names may only be abbreviated from within 
FUTIL, as the abbreviations are not recognized at O/S command level. 
Other keywords can be abbreviated both within FUTIL and at O/S com- 
mand level. | 


1. 


Formal. A formal abbreviation is available for some keywords. It 
must be precisely spelled out. For example, the command 
COPYTEXT has the formal abbreviation CT. 


Minimal. Most keywords may be abbreviated by the minimum 
number of characters needed to identify the keyword within its 
appropriate context. Any number of additional characters may be 
typed, up to the full name. For example, YES may be typed as Y, 
YE, or YES. More than one or two letters may be required to 
uniquely identify some options (e.g., NOS is the minimum 
abbreviation for NOSHIFT, NOP for NOPROTECT, etc.) 
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Normal Commands ADD (A) 
Appends data to magnetic tape files. ADD must follow immediately 
after the COPY command used to initiate the magnetic tape file; or 
another ADD command. | 
ADD is not an O/S command; it is only available inside FUTIL. 
SYNTAX 
ADD[/Options] 
[Catalog[/Filenamelist][/Options]]] 
[Catalog[//Options]] 
COMMENTS 


ADD is identical to COPY, except that its Destination field cannot have 
the device specification. 


Magnetic tapes must be in FUTIL or SAVFIL/RSTFIL format. 
All tape options relating to destination tape device must have been 
specified in the Optionlist of the COPY command preceding the ADD. 


The only exceptions are the CHECK and NOCHECK options which re- 
main effective for subsequent ADDs until respecified. | 


CHECK 

Checks magnetic tape files against the original disc copies. 
SYNTAX 

CHECKI/Options] Catalog[/Options] 
COMMENTS 

The Source must be a magnetic tape unit. 

Magnetic tapes must be in FUTIL or SAVFIL/RSTFIL format. 


Neither the Catalog and Filenamelist of the Source field, nor the entire 
Destination field, are allowed. 


Only tape related options are allowed in the Optionlist. 
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Normal Commands CONVERTB 
(Continued) 
Identical to CONVERT except that it does only binary file conversions. 
All files are copied as binary files without any character set conversions. 
SYNTAX 
CONVERTBI/ Options] 
[Catalog[/Filenamelist][/Options]] 
[Catalog| //Options]] 
COMMENTS 
CONVERTB does not process text files. 


COMDEV or line printer are not allowed as Destination devices. 


COPY (C) 


Performs basic FUTIL file transfer functions. Copies files from one device 
or catalog to another. 


SYNTAX 
COPY[/Options] 
[Catalog| /Filenamelist][/Options]] 
[Catalog[//Options]] 
COMMENTS 


If the Destination is a COMDEV device specification, COPY is the same 
as PRINT (&BCD catalog level needed). 


If the Destination is a HARDEV device specification, COPY is the same 
as PRINTLP (&BCD catalog level needed). 


DRWUPDAT OPTIONS 
COPY/DRWUPDAT simplifies the restoration of updated versions of 


parts. (It assumes that speed is not critical and that very few parts are 
being restored in an single command specification.) DRWUPDAT is only 
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Normal Commands valid for the COPY command. The full specification of the COPY com- 


(Continued) 


mand may be used with the following exceptions: 


e The Source device must support a catalog structure (i.e., it must be 
the disc, a FUTIL format tape, or a SAVFIL/RSTFIL format tape). 


e Disc must be the Destination device. 


e Atleast the terminating level of each part name must be specified in 
the Filenamelist of the Source rather than in the catalog name. 


Because a part name is actually a subcatalog in the file structure, the 
SUBCAT option is automatically in effect when this option is specified. | 
The actual execution of the command is accomplished in two phases. 


' @ Restoration phase — searches the Source catalog for valid part 
names and restores them. 


¢ Deletion phase — searches the Destination catalog for valid part 
names and deletes them. 


As a filename change may be indicated by the command specification, 


the deletion phase operates only on those parts that have a valid destina- 
tion name. 


DELETE (D) 
Deletes specified files (disc files and catalogs only). 
SYNTAX 


DELETE[/Options] 
[Catalog[/Filenamelist][/Options]] 
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Normal Commands _ LIST (L) 


(Continued) 
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Lists contents of disc catalogs or magnetic (L) tapes. 
SYNTAX 


LIST[/Options] 
[Catalog[ /Filenamelist][/ Options]] 
[Catalog[//Options]] 


COMMENTS 


There is only one valid Destination field; a device specification for either 
the COMDEV or HARDEV. The default is the COMDEV. Files are listed 
on the Destination device. 


Magnetic tapes must be in FUTIL or SAVFIL/RSTFIL format. 
File Listing Format 


Information for each file listed is printed the same way, irrespective of 
FORMAT the items actually listed. Options designate desired informa- 
tion for the list. If file information is not available, the appropriate list 
field is blank. Information for each file is printed on one or more lines of 
up to 80 characters. 


The tape file position number and full file name are always listed. When 
no list options are specified, each file’s creation date and time are listed. 
If options are specified, only information requested is listed. 


Information is listed in order, left-to-right, top-to-bottom. All numerical 
information is HEXIDECIMAL. 


File position number — always listed (tape) 


Filename — always listed 


Creation date and time — default 


Full size in sectors (disc) 
Contiguous Flag 
“" — file is contiguous 
weer’ — file is not contiguous 
“V/n"’ - entry is a volume enabledon disk drive n. (0 <n< 3) 


File type 
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Normal Commands e 


(Continued) 


Protection code 
CHKSUM 


DLOC (disc) 
Contiguous flag (as above) 


First contiguous chunk (disc) 
Catalog flags (disc) 
Last access date 


User attribute words 


Magnetic Tape Listing Format 


Information is listed for each file and for certain magnetic tape formats. 


1. 


SAVFIL/RSTFIL format tapes. Tape file type (i.e., SAVFIL) and 
creation date/time precedes individual file. 


FUTIL format tapes. Tape file label information precedes that for 
individual files. 


All numerical information is in DECIMAL and the information is printed, 
in order, on one line. 


File number (the n of :MTn). 


File section number (1 only if the file extends across more than one 
reel of tape.) 


Tape file creation date (Julian date). 

Tape file expiration date (The Julian date 99/999). 

The version of FUTIL that createdthis tape file (tape file name). 
The version of the O/S current when the tape file was created. 
File set ID (VOLSER of the first reel in the set). 

VOLSER of the current reel. | 

Text content of the USR3-USR9 labels, if they exist. 
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Normal Commands — LISTLP (LL) 
(Continued) | 
Lists contents of disc catalogs or magnetic tapes. LISTLP resembles 
LIST, except the Destination is omitted; output always goes to the line 
printer. | 
SYNTAX 


LISTLP[/Options] 
[Catalog[/Filenamelist][/Options]] 


MOVE (M) 
Moves files from one device, catalog, or file to another. 
SYNTAX 
MOVET[/ Options] 
[Catalog| / Filenamelist][/Options]] 
[ Catalog[//Options]] 
COMMENTS 
MOVE is identical to the COPY command, except when the operation is 
on disc files. In that case, the original source files are deleted upon suc- 
cessful completion of the copy. 
Caution 


Moving a file to itself deletes the file. 


QUIT (QU) 


Exits FUTIL internal command level to return to the O/S prompt. QUIT 
is not valid at O/S level. 


SYNTAX 


QUIT 
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FUTIL text commands operate only on type 3 and 5 files (with &BCD as 
the next-to-last level in the full filename; e.g., A.B.&BCD.C). When speci- 
fying catalog or filenames for these commands, omit the &BCD. 
(e.g.,A.B.&BCD.C must be specified as A.B.C.). 


Text commands (Formal abbreviations) and substitutions: 


e ADDTEXT (AT)  —_ substitute ADD 

e CONVERT — need Filenamelist specification 
¢ COPYTEXT (CT) —_ substitute COPY 

e LISTTEXT (LT) — substitute LIST 

e PRINT (P) — substitute COPY 

e PRINTLP (PL) — substitute COPY 


A Source specification of A.B.C can refer to both the catalog | 
A.B.C.&BCD and the file A.B.&BCD.C. The files in the catalog and the 
single file are all processed. If only the single file or full catalog is desired, 
use the non-text form of the command with an &BCD catalog level. An 
appropriate Filenamelist specification can also filter the desired filenames. 


ADDTEXT (AT) 

Identical to the ADD command, but limited to text files. 
SYNTAX 

ADDTEXTI/Options] 


[Catalog[/Filenamelist][/Options]] 
[Catalog[//Options]] 


CONVERT 


Copies/converts special format magnetic tape files. Generally used with 
fixed-block, fixed-record tapes. CONVERT is limited to text files. 


Additionally, CONVERT reads or punches paper tape; and reads cards. 
It provides conversions for several industry standard character sets. 


SYNTAX 


CONVERT[/Options] 
[Catalog| /Filenamelist][/Options]] 
[Catalog[//Options]] 
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COMMENTS 


CONVERT is a special version of the COPY command with a slightly dif- 
ferent syntax. It is used for special magnetic tape formats (Blocked Tape 
Format/Device), and for character set conversions. CONVERT transfers 
text files to and from non-CV machines and non-standard devices such 
as paper tape or cards. 


e The Source may be a magnetic tape unit, paper tape reader, card 
reader, or CV text file or catalog. 


e The Destination may be a magnetic tape unit, paper tape punch, or 
CV text file. 


_@ The Filenamelist is only allowed when the Source is a catalog, or a 
FUTIL or SAVFIL/RSTFIL format magnetic tape. 


CONVERT has several tables for converting standard character sets. 
Character set conversions are described under the CONVERT option. 


File specification format depends upon the physical devices used. 


1. 


lf the Source is a non-standard device (blocked tape device, card 
reader or paper tape reader), the Destination may be: 


Full name of a disc file to be created from the tape file (without 
&BCD catalog). 


A HARDEV or :LP. (The only way to PRINTLP a text file on a 
blocked tape device.) 

The COMDEV or :CM. (The only way to PRINT a text file on a 
blocked tape device.) | 


Another non-standard device (blocked tape device or paper tape 
punch). 


If the Destination is a non-standarddevice (blocked tape device or 
paper tape punch), the Source may be: 


A disc catalog or filename, without the &BCD level. In this case 
only, the Filenamelist and the file specification options are valid. 
If more than one file is CONVERTed each file goes into a 
separate file on the Destination device. For the paper tape 
punch this puts a leader between the files; for the blocked tape 
device this means that the n of the :MTn is incremented by one 
for each file. 


Another non-standard device (blocked tape device, a card 
reader or paper tape reader). In this case, only one file ts 
CONVERTed. 
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Text Commands OPTIONS 

(Continued) 
CONVERT supports four special operations through specific uses of 
either the CONVERT option or the FORMAT option. These operations 
were individual O/S commands on versions of the O/S prior to CGOS 
200. 


e MICARDS 


Users of MICARDS can get the same results by using CONVERT 
with the following special use of the FORMAT option: 


FORMAT = (RECSIZ=80,RECCNT = 1) 


—@ IPC 


Users of IPC can get the same results by using CONVERT with the 
following special use of the FORMAT option: 


FORMAT =(RECSIZ = 80, RECCNT = 20) 


EIAIN, EIAOUT 


Users of EIAIN and EIAOUT can get the same results with the 
following CONVERT formats: 


— CONVERT=EI-C  (EIAIN) 

— CONVERT=EA-C (EIAIN,ASCII) 
— CONVERT=C-El (EIAOUT) 

— CONVERT=C-EA (EIAOUT,ASCII) 


COPYTEXT (CT) 

Identical to the COPY command except that it only copies text files. 
SYNTAX 

COPYTEXT[/Options] 


[Catalog[/Filenamelist][/Options]] 
[Catalogl//Options]] 
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Text Commands LISTTEXT (LT) 
(Continued) 
Identical to the LIST command except that it only lists text files. 


SYNTAX 
LISTTEXT[/Options] 


[Catalog[/Filenamelist][/Options]] 
[Catalog[//Options]] 


PRINT (P) 
Prints text files on a COMDEV or HARDEV. The systemprinting toggles 
(AP and AU) direct output. As a text command, PRINT only processes 
text files. 


SYNTAX 


PRINTI[/Options] 
[Catalog| /Filenamelist][/Options]] 


COMMENTS 


Files printed go into a hardfile if one is active. HARDEV format informa- 
tion does not go into the hardfile. 


Unless otherwise specified, PRINT prints each file without line numbers. 
PRINT formats the files for the COMDEV as it prints them. If the files are 


going to a HARDEV, HARDEV formatting is used. Formatting options 
are specified in the Optionlist. 
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PRINTLP (PL) 


Prints text files on a HARDEV. Types out error error messsage and stops 
if no HARDEV Is available. PRINTLP ignores the system printing toggles 
(AP and AU). As a text command, PRINTLP only processes text files. 


SYNTAX 


PRINTLP[/Options| 
[Catalog[/Filenamelist][/Options]] 


COMMENTS 
Files printed will not be written to a hardfile. 
Unless otherwise specified, PRINTLP prints each file with line numbers. 


PRINTLP formats files as it prints them. The format specifiers are all 
available as options in the Optionlist. 


Enter options, separated by commas, in one of the three Optionlist fields. 
Some options apply to a particular command or a device; some have a 
general application with possible exceptions. Options disallowed for par- 
ticular commands are flagged as errors or completely ignored. When an 
option is stated more than once in a command, the last use prevails. 


The following options are used to identify particular files to be processed 
by a command. 


BEFORE SINCE 
EXCEPT —  SUBCAT 
LEVEL TYPE 
NLEV 
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File Specification BEFORE 
Options (Continued) 
Belongs to the Source Optionlist. 
Selects files last accessed prior to a given date. 
SYNTAX 
BEFORE = date 
Date is in the form: 
mm-dd-yy[:hh[:mmI[:ss]]] 


(month-day-year:hours:minutes: seconds) 


Default is all dates. 


EXCEPT 


Belongs to the Source Optionlist. 


Ordinarily files listed in the Filenamelist are the Source files that are to be 
processed. EXCEPT selects all files in the Source catalog EXCEPT those 


specified in the Filenamelist. 
SYNTAX 
EXCEPT 


Filenamelist field must not be empty. 
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File Specification LEVEL 
Options (Continued) 
Belongs to the Source Optionlist. 


Defines depth of file search and name-matching process. 


SYNTAX 
LEVEL=n 
or 
LEVEL=N 


Default is LEVEL=N. 
LEVEL=N 


searches the primary Catalog and any subcatalogs to their maximum 
depth. 


e With an empty Filenamelist, the entire contents of the catalog 
satisfy the search. 


e With names in the Filenamelist, all files in the primary Catalog 
whose names terminate with a Filenamelist name satisfy the search. 
LEVEL=n 
Searches the primary Catalog to the nth level (n = 0). 
e With an empty Filenamelist and n=O, only the primary Catalog 


satisfies the search. 


e With an empty Filenamelist and nO, all files with up to n name levels 
beyond the primary Catalog name satisfy the search. 


e With names in the Filenamelist and n = 0, only files in the primary 
Catalog that match names in the Filenamelist satisfy the search. 


e With names in the Filenamelist and nO then ail files up to n in- 
termediate levels that terminate in a Filenamelist name satisfy the 
search. 

COMMENT 


When the SUBCAT option is used, the search is up to n levels beyond 
the subcatalog name(s) specified in the Filenamelist. 
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NLEV 
Belongs to the Source Optionlist. 
Searches all levels of the primary Source catalog. If the Filenamelist has 
names, any files from the primary Source catalog are used if their ter- 
minating levels match a name in the list. 
NLEV is equivalent to LEVEL=N. 

SYNTAX 


NLEV 


SINCE 
Belongs to the Source Optionlist. 
Only use those files dated after date. 
SYNTAX 
SINCE = date 
Date is in the form: 
mm-dd-yy--[:hhl:mm[:ss]]] 


(month-day-year:hours:minutes: seconds) 


Default is all dates. 
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File Specification 
Options (Continued) 


SUBCAT 


Belongs to the Source Optionlist. 


Each name in the Filenamelist becomes a catalog within the primary | 
Source catalog. The names in the Filenamelist must exist in the lowest 

levels of the Source catalog, i.e., those names are appended directly 

onto the primary catalog name. 


SYNTAX 


SUBCAT 


Valid only when the Filenamelist field is not empty. 


TYPE 


Belongs to the Source Optionlist. 


Specifies file types to be processed. All files have a system type attribute 
that defines the use of the file to certain utilities or programs. 


SYNTAX 


TYPE=n 

TYPE#n 

TYPE= name 

TYPE#name 

TYPE = (n1[-n2][,name1][,...]) 
TYPE#(n1[-n2][,namet][,...]) 


n, ni, n2 are hex numbers between 0 and OFFx. (All hex numbers must 
start with a digit.) 


name, name! are names one to eight characters long starting with a let- 
ter and consisting of letters and digits. 


= means equal. 


# means not equal or EXCEPT. 
Default is all types — TYPE = (0-OFF) 
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File Specification COMMENTS 
Options (Continued) 

| There are several ways to indicate file types (see above). A type can bea 
single hex number; it can be a generic type name; it can be a range of 
hex numbers; or it can be some combination of all of these. Any time 
more than a single type is specified, the whole list must be enclosed 
within parentheses. Commas separate individual specifications within 
the parentheses. 


Generic file types are a means of specifying the file type with a name 
instead of a hex number. Single types, ranges of types or a combination 
of both may be specified by a single generic name. 


~ When given in the TYPE option, the string of single numbers or ranges 
(separated by commas) is substituted for the specified name. (Use of 
generic types in the command specification slows down command 
execution.) The list of type names and substitution strings is kept in a 
special text file which must be opened, read and then closed for each 
generic type name specified. 


Defined Generic Types 


ACCT = OB 
BATCH =  OQBO-OBF 
CATALOG = 1 
COMTAB = 8 
CNFG = 4 
C4PARTS = = 20-22 
GENERAL = 0 
OBJECT = 2 
OVERLAY = 7 
PEPOBJ = 6 
SYMFILE = @Q 
TEMP = OFF 
TEXT = 3,5 
UNDEF = 0 
ZBOFIN = OF 
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Conversion Options — The following options are only used for the CONVERT and CONVERTB 


commands: 
CONVERT (CONVERT only) 
FORMAT (CONVERT & CONVERTB) 
BLKSIZ 
RECCNT 
RECSIZ 
LASTBLK (CONVERTB only) 
LBLS (CONVERT & CONVERTB) 
LEADCHAR (CONVERT only) 
LEADER (CONVERT & CONVERTB) 
CONVERT 


Belongs to the Command Optionlist. 


Converts character set i (on the Source device) to character set o (on the 
Destination device). 


SYNTAX 


CONVERT =!1-o 


ican be: A, BD, BI, C, E, EA, or El. 
o can be: A, BD, BI, C, E, EA, or El. 


Default is CONVERT =C-C 

COMMENTS 
Applies to text conversion. It is valid only with the CONVERT command. 
The following standard character sets are supported for conversion in 
both directions: | 
A — Standard 7-bit ASCII 
BD— DEC 6-bit BCD 


BI — IBM 6-bit BCD 
C — CV's internal character set (8-bit ASCII, high-order bit is always 


on). 
E — EBCDIC | 
EA — Special EIA even parity ASCII. (Only valid on a PPTDEV or 
RPTDEV). 


El — Special ElA character set. (Only valid on a PPTDEV or RPTDEV). 
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Conversion Options FORMAT 
(Continued) — 

>" Can be either a Source or Destination option. Describes the physical 
data structure on a blocked tape device. Sub-options (option1, option2) 
identify the actual data format of the tape. 


SYNTAX 
FORMAT = (option! = n1,[option2 = n2]) 


option! — may be BLKSIZ, RECCNT, RECSIZ 
option2 — may be BLKSIZ, RECCNT, RECSIZ 


optioni may not be the same as option2. n1 and n2 are decimal 
numbers. 


COMMENTS 
The tape format is determined according to the formula (BLKSIZ= - 
RECCNT*RECSIZ). Only two of the sub-options are necessary. If only 
one is specified (or the FORMAT option is not specified at all), defaults 
are used for the format. These defaults are based on the maximum 
BLKSIZ and the maximum RECSIZ. If used with the CONVERTB option, 
only BLKSIZ is applicable. | 

OPTIONS 

e BLKSIZ 


The number of bytes in a data block on the blocked tape device. n/2 is 
the number of words in the data block. This must be an even number. 


SYNTAX 
BLKSIZ=n 
2<n <s 8192 

COMMENTS 


BLKSIZ is a sub-option of the FORMAT option. 
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Conversion Options 
(Continued) 


¢ RECCNT 


Number of logical data records in a physical block on the blocked tape 
device. 


SYNTAX 


RECCNT =n 

n= 1 
COMMENT 

RECCNT, a sub-option of the FORMAT option, is not allowed in the 
| CONVERTB command. 
RECSIZ 


The number of bytes in a data record on the blocked tape device. The 
number of words will be (n+ 1)/2 — not necessarily an even number. 
There may be more than one data record in a data block. However, if 
RECSIZ is odd, there must be an even number of records in the physical 
block. 


SYNTAX 


RECSIZ=n 
1< n < 255 


COMMENT 


RECSIZ, a sub-option of the FORMAT option, is not allowed with the 
CONVERTB command. 
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Conversion Options LASTBLK 


(Continued) 


3-122 


Belongs to the Destination Optionlist. 


Specifies the number of bytes in the last physical block to actually write 
out to magnetic tape. 


SYNTAX 
LASTBLK=n 
0 <n < 8196 


n must be even. 
n is the maximum size of the last block to be output. 


If n is less than actual size of the last block, the words are written out to 
the tape. 


The default is to write out the entire block. 
COMMENTS 
LASTBLK can only be used with CONVERTB. 
LASTBLK enables you to write only valid data to the last physical block 
on the tape. Of course, it is still your responsibility to ensure the validity 


of all data sets to the tape. The case where a disc file’s final sector con- 
tains only valid data is extremely rare. 


LBLS 
Specifies that the blocked tape being converted has ANS! standard tape 
labels. Can be either a Source or Destination option. Affects the Source 


device if used as a Source option, and the Destination device if used as a 
Destination option. 


SYNTAX 


LBLS 
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Conversion Options LEADCHAR 

(Continued) 
Belongs to the Destination Optionlist. 
Specifies a special character to use for leader on paper tape. The 
LEADER option specifies how many feet of this special leader character 
to punch before at the beginning and end of the tape. This leader is pun- 
ched in addition to the standard 00 leader punched. Only valid for 
PPTDEV. 

SYNTAX 


LEADCHAR = ch 
LEADCHAR = /ch 


ch is any valid character. 
Default is 0 (no character). 
COMMENTS 
The slash (/) is an escape to enable certain characters to be specified as 


leader (such as -space- and -/-). The desired character immediately 
follows the slash. | 


LEADER 
Belongs to the Destination Optionlist. 


Specifies the number of feet of leader and trailer to punch on a paper 
tape. It is only valid for the PPTDEV. 


SYNTAX 
LEADER=n 
O<n <= 273 


Default is 1. 
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Individual LIST command options are valid for disc files, tape files, or both. | 
LIST options belong in the Command Optionlist, nee they control the 
output format of the listing. 


LIST options: 
DLOC | (disc only) 
FULL (disc & magnetic tape) 
FULLNAME (disc only) 
LABELS (magnetic tape only) 
LIST (disc & magnetic tape) 
SYSTEM (disc only) 
TEMPFILS (disc only) 
USER (disc & magnetic tape) 
DLOC 


Belongs to the Command Optioniist. 

Lists the absolute disc location for specified files. This option is only 
valid for listing information about disc files. Also includes the contiguous 
flag, if not listed with the file size. 


SYNTAX 


DLOC 


FULL 
Belongs to the Command Optionlist. 
Lists these five items for each file: creation date and time, file size in sec- 
tors (plus contiguous flag if disc), file type, file protection group, and file 
checksum. This option is equivalent to LIST = DSTPC. 

SYNTAX 


FULL 
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List Command FULLNAME 
Options (Continued) 
Belongs to the Command Optionlist. 


When listing files on the disc, will list the full pathname (including the 
working directory name) for each file listed. 


SYNTAX 


FULLNAME 


LABELS 
Belongs to the Command Optionlist. 
Prints information only about the tape file or files requested (the label or 
header information). Does not list information for FM files. The informa- | 
tion listed is described with the LIST command. 


SYNTAX 


LABELS 


3-125 


FUTIL 


The information and drawings contained herein are the sole property of Computervision 
Corporation. Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
xpress written consent of Computervision. 


List Command 
Options (Continued) 
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LIST 
Belongs to the Command Optioniist. 


Lists the information specified by x for each file. x can be any combina- 
tion of the following letters. 


D = creation date and time. 

file size in sectors (plus contiguous flag if disc). 
file type. 

protection group. 

file checksum. 


QO vAWN 
Il 


SYNTAX 


LIST =x 
x can be one or more of: D, S, T, P, C. 
EXAMPLES LIST=S, LIST=PT, LIST=DSTPC, etc. 


SYSTEM 
Belongs to the Command Optioniist. 
Requests that the following information be listed for each file: system 
flags (15th word of the catalog entry), absolute disc location of the file 
(same as DLOC option), and size in sectors of the first contiguous chunk 
alocated. Valid for disc files only. 


SYNTAX 


SYSTEM 


TEMPFILS 
Belongs to the Command Optionlist. 


Requests that all temporary files in the catalog also be included in the 
listing. Valid for disc files only. 


SYNTAX 


TEMPFILS 
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List Command USER 
Options (Continued) | 
Belongs to the Command Optionlist. 


Lists user information for the file; including last access date and two 
user attribute words. 


SYNTAX 
USER 
Magnetic Tape These options control magnetic tape data formats, data integrity checks 
Options and tape positioning. 


Tape options: 


ALL 
CHECK/NOCHECK 
COLD 

LABEL 

OVERLAST 
RSTFIL/SAVEFIL 
TAPEFILE 
USERLBLS 


ALL 
Belongs to the Source Optionlist. 
Lists information about tape files on a reel or in tape file sets, depending 
on particular tape format used. The information printed also depends 
upon the format in question. 


SYNTAX 


ALL 
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CHECK 


Specifies whether a check pass is to be done while copying files to 
magnetic tape. 


SYNTAX 
CHECK 

COMMENTS 
The option is currently implemented for disc-to-tape copy and Is ignored 
when the copy is tape-to-tape. CHECK is valid only for the command in 
which it is specified (except for the ADD/ADDTEXT commands). Fur- 
ther, it applies only to SAVFIL/RSTFIL and FUTIL format tapes. Due to 
the check pass mode of operation, it is usually faster to create the tape 
first and then use the CHECK command for the check pass on the new 


tape file. 


The check pass is not the default, but must be explicitly requested. 


COLD 
Can be either a Source or Destination option. 
Indicates the presence of a foreign file on a tape reel. 

SYNTAX 
COLD 

COMMENTS 
COLD should only be used if there is system coldstart file as the first file 
on the reel. When the COLD option is specified, the VOL1 label follows 
the coldstart file and all files and file number specifications refer to those 


files following the coldstart file on the reel in question. Applies only to 
SAVFIL/RSTFIL and FUTIL format tapes. 
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Magnetic Tape LABEL 
Options (Continued) 
Belongs to the Destination Optionlist. 


Specifies whether or not a VOL1 label is to be written on the first reel of 
tape in a copy to tape function. 


SYNTAX 
LABEL 
LABEL = /xxxxxx/ 


/ is any delimeter character. 
x is a legal tape label character. 
0 to 6 different characters may be used. 


COMMENTS 


If LABEL Is not invoked as an option then a VOL1 label must already ex- 
ist on the reel. Of course, this option only has meaning if the tape format 
being created supports ANSII tape labels. (FUTIL format or Blocked 
Tape Format with the LBLS option.) 


The first specification causes FUTIL to prompt for the VOLSER number. 
The VOLSER must be entered at the COMDEV even if an execute file is 
running. 


The second specification indicates actual VOLSER number to be placed 
in the VOL1 label. There is no COMDEV prompt or input. The characters 
comprising the VOLSER must be between two two identical delimeters 
(the /’s). The first non-blank character following the = is the delimeter. 
The VOLSER number can be from 0 to 6 characters long. If less than 6 
characters are entered, VOLSER is left-justified and blank-filled. 
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NOCHECK 
Belongs to the Destination Optioniist. 


Cancels the CHECK option. NOCHECK is used primarily with the 
ADD/ADDTEXT command to cancel a CHECK from the initiating COPY 
or a previous ADD command. When NOCHECK is requested, no check 
pass is done on saved files. 


SYNTAX 


NOCHECK 


OVERLAST 
Belongs to the Destination Optionlist. 


OVERLAST overwrites the specified tape file number. Normally, the 
new tape file follows the tape file specified in the command. This option 
is meaningless unless the copy is to magnetic tape and 
TAPEFILE=LAST, TAPEFILE=1 or :MT-1 has been used to specify the 
tape file to write to. 


SYNTAX 


OVERLAST 


RSTFIL 
Can be either a Source or Destination option. 


OVERLAST is only for creating or reading of tapes compatible with 
CADDS 3 Rev 10 (and earlier) systems. Indicates that the tape file is to 
be written/read in the SAVFIL/RSTFIL format, instead of the normal 
FUTIL backup tape format. This option may be used to force the SAV- 
FIL/RSTFIL format under all conditions in which the FUTIL format 
might be used. The ADD command may also be used with the SAVFIL 
option, but the option must be specified with the initiating COPY com- 
mand and can not be specified with any of the subsequent ADD’s. 


SYNTAX 


RSTFIL 
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Magnetic Tape 
Options (Continued) 


SAVFIL 


Can be either a Source or Destination option. 


RSTFIL is only for the creation or reading of tapes compatible with 
CADDS 3 Rev 10 (and earlier) systems. Indicates that the tape file is to 
be written/read in the SAVFIL/RSTFIL format instead of the normal 
FUTIL backup tape format. This option may be used to force the 
SAVEFIL/RSTFIL format under all conditions in which the FUTIL format 
might be used. The ADD command may also be used with the SAVEFIL 
option, but the option must be specified with the initiating COPY com- 
mand and can not be specified with any of the subsequent ADD’s. 


SYNTAX 


SAVEFIL 


TAPEFILE 


Can be either a Source or Destination option. 


Positions the tape to the tape file specified. It has the same effect as the 
file number in the tape device specification (n of :MTn). 


SYNTAX 


TAPEFILE = option 


option can be FIRST, LAST orn 
-1 <n < 65,574 ~~ 


Default is FIRST. 


FIRST 
Positions to the first tape file on the tape reel. 


LAST 
Positions to the last tape file on the tape reel. 


n 
Positions to the specific numbered tape file in the file set. 


n = -1 is the same as LAST: 
n = Ois the same as FIRST. 
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Magnetic Tape 
Options (Continued) 
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COMMENTS 


TAPEFILE overrides any position information, see the section on 
devices. 


Tape file definition depends on tape format. 


USERLBLS 


Belongs to the Destination Optionlist. 


Allows you to specify information about a magnetic tape file in the ANSI 
labels preceding the data in that particular file. This information is writ- 
ten on the tape as arbitrary text strings in the standard labels USR3- 
USR9. (USR1 and USR2 labels are reserved for future use and contain 
blanks.) 


SYNTAX 


USERLBLS 


COMMENTS 


After writing the HDR1 label for the tape file, FUTIL creates the two 
blank labels USR1 and USR2. FUTIL then prompts with a greater-than 
sign (>) for the text to go into the rest of the USR labels. A single line of 
text, terminated with a }, goes into a single label. Up to 76 characters are 
allowed for any one line 7 lines (7 labels) may be entered. A single empty 
line ), immediately following the prompt, terminates entry of the label 
text. If all 7 lines are entered, FUTIL won’t prompt for the 8th line but 
just start the normal processing for the command. If the tape file in 
question extends across several reels, new USR labels are constructed 
for each section of the file as described above. 
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Magnetic Tape 
Options (Continued) 


Printing Options 


The text for the labels must be entered from the COMDEV, even when 
an execute file is running. 


This option applies to all tape formats that support ANSI tape labels. 


Printing options control text output on the HARDEV and COMDEV. Cer- 
tain options are relevant only to HARDEV formatting; others apply to all 
printed output. Exclusive HARDEV options are ignored if specified for 
COMDEV output. If the text is printed on both the COMDEV and 
HARDEV, HARDEV characterstics take precedence. 


Printing options are: 


COPIES 
DIGITS 
FILEHEAD 
LENGTH 
LINES 
MARGIN 
PAGENUMS 
WIDTH 


COPIES 
Belongs in Command Optionlist if the printing Destination device is 
omitted. Belongs in the Destination Optionlist if the Destination device is 


either COMDEV or HARDEV. 


Specifies the number of copies of each file to print. All the files specified 
are printed consecutively before the next set of duplicates is printed. 


SYNTAX 
COPIES =n 
n is any permissible integer greater than 0. 


Default is 1. 
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DIGITS 
Belongs in Command Optionlist if the printing Destination device is 
omitted. Belongs in the Destination Optionlist if the Destination device is 
either COMDEV or HARDEV. 


Specifies number of characters to use for printing line numbers of the 
text files being printed. 


SYNTAX 
DIGITS =n 
Q0O<=n <1 


Default is DIGITS =O for PRINT (:CM). 
Default is DIGITS =6 for PRINTLP (:LP). 


DIGITS =0 is always true for LIST (the option is ignored if specified for 
list). 


COMMENTS 


This count includes the / separating each line number from the line 
proper. | 


When the number of characters in the line exceeds n, the n rightmost 
characters in the line (including / are printed. 


Line numbers are always right justified and blank filled. 
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Printing Options FILEHEAD 

(Continued) 
Belongs in Command Optionlist if the printing Destination device is 
omitted. Belongs in the Destination Optionlist if the Destination device is 
either COMDEV or HARDEV. 


Specifies the page headline for each file printed. The value of the option 
defines the headlines as follows: 


ALL 


The filename and file date are printed at the top of each physical 
page of each file. (Applies only to the physical HARDEV.) 


~ ONE 


The filename and date are printed only at the top of the first page 
of each file. 


NO 
No headline is printed for any file. 


SYNTAX 
FILEHEAD = option 
option is any one of: ALL or ONE or NO. 
Default is FILEHEAD = ONE 
COMMENTS 
When specified for the LIST command, this option is ignored. 


LIST 


command default is FILEHEAD = ALL. 
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LENGTH 


Belongs in Command Optionlist if the printing Destination device is 
omitted. Belongs in the Destination Optionlist if the Destination device is 
either COMDEV or HARDEV. 


Defines the number of physical lines on a page. A page eject is sent to 
the line printer after n lines have been printed. If n = 0, no automatic 
page ejects are done. 


SYNTAX 


LENGTH=n 


or 


12 <= n S maximum HARDEV page length. 


Default is maximum HARDEV page length. 


COMMENTS 


Applies to printing on the physical HARDEV and has COMDEV or 
HARDFILE output. The maximum page length and the default page 
length are dynamically determined when the print request is initiated. If 
the value for LENGTH exceeds the page length of the HARDEV, the 
length is set to the default. 


Printing Options 
(Continued) 


FUTIL 


The information and drawings contained herein are the sole property of Computervision 
Corporation. Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
express written consent of Computervision. 


LINES 
Belongs in Command Optionlist if the printing Destination device is 
omitted. Belongs in the Destination Optionlist if the Destination device is 
either COMDEV or HARDEV. 
Specifies the range of lines to print for all the files being printed. n1 is the 
first line printed and n2 is the last line printed. The default is to print the 
entire file. n2 is optional. 

SYNTAX 
LINES =n1[-n2] 
1< nil s 4,294,967,295 
1 < n2 < 4,294,967,295 


nl < n2 


Default for n1 is 1. 
Default for n2 is file end. 


MARGIN 
Belongs in Command Optionlist if the printing Destination device is 
omitted. Belongs in the Destination Optionlist if the Destination device is 
either COMDEV or HARDEV. 


Specifies a top and bottom margin for a printed page; both of n lines. 
These margins are in addition to any that the HARDEV Itself may define. 


SYNTAX 


MARGIN=n 
0 <n <=10 
Default is MARGIN =0. 


COMMENTS 


Applies only to printing on the HARDEV and is ignored for COMDEV 
and HARDFILE output. Default is the full page length of the HARDEV. 
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PAGENUMS 


Belongs in Command Optionlist if the printing Destination device is 
omitted. Belongs in the Destination Optionlist if the Destination device is 
either COMDEV or HARDEV. 


Sequentially numbers the pages of each file printed. Applies only to 
HARDEV output and does not affect output to the COMDEV or a 
HARDFILE. 

SYNTAX 


PAGENUMS 


WIDTH 

Specifies the number of characters to print on a physical line. 
SYNTAX 

WIDTH =n 

12 < n < maximum carriage width of the HARDEV < 255 


Default is the maximum carriage width of the HARDEV 
or 
maximum carriage width of the COMDEV if there is no task HARDEV. 


COMMENTS 


The maximum and default are dynamically determined from the 
HARDEV at print initiation time, or from the COMDEV if there is no 
HARDEV. Whenever a HARDEV becomes available for printing (as 
when P is typed during a PRINT command), width changes to HARDEV 
default (unless WIDTH < maximum is specified). Even if output is 
directed to both HARDEV and COMDEV, default and maximum widths 
are determined by HARDEV information. 
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Printing Options Entering a WIDTH > maximum invokes the default value. If a printed 
(Continued) line is longer than the allowed width, the line is continued on as many 
physical lines as possible. Each continuation is flagged. 


Default for the LIST & LISTTEXT commands is 80. 


Miscellaneous The following options perform miscellaneous functions. 
Options | 

ARCHIVE/NOARCHIVE 

ASK 

CHECKSUM 

DISKPOS 

DRWUPDAT 

LIST 

NEWCHAR 

NEWDATE/OLDDATE | 

PROTECT/NOPROTECT 

REPLACE 

SHIFT/NOSHIFT 

SRCHLIM 


ARCHIVE 
Belongs to the Command Optionlist. 
Interfaces with ARCHSRCH, the file indexing utility program. Under the 
ARCHIVE option, FUTIL retains the following information about 


destination files for ARCHSRCH future reference: 


e FILENAME Without site, volume or tape file number. 


e STORAGE disc: Site and volume number. 
LOCATION tape: VOLSER and tape file number. 


e FILE TYPE 
e DATE and TIME of archiving. 


SYNTAX 


ARCHIVE 
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Miscellaneous 
Options (Continued) 
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COMMENTS 


ARCHIVE is valid only when the Destination device is disc or FUTIL 
format tape and only for these commands: 


ADD, ADDTEXT, COPY, COPYTEXT, MOVE 


ARCHIVE, if used with any valid command except MOVE, will remain in 
effect for subsequent ADD and ADDTEXT commands _ unless 
NOARCHIV is specified. 


When ARCHIVE is in effect, FUTIL undergoes a special termination 
procedure at the end of each session. It prompts you for a valid 
ARCHSRCH archive file name. Information about each file processed is 
passed to ARCHSRCH for storage. Entering } instead of a filename 
aborts the process and prevents storage of archive information. 


ASK 


Belongs to the Source Optionlist. 


Prompts for OK response before processing each file. If any other 
response is entered, FUTIL skips to the next file without processing the 
current file. 


SYNTAX 


ASK 


COMMENTS 


The OK response must come from the COMDEV even if an execute file 
is running. Applies to all commands except LIST and LISTTEXT. 
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Miscellaneous 
Options (Continued) 


CHECKSUM 


Belongs to the Destination Optionlist. 


Indicates whether CHKSUMs will be validated when files are copied. 
The CHKSUM is an internal check for data validity in a file. When the 
CHKSUM for the original version does not match the CHKSUM for the 
copy, this implies that file data is no longer good. 


SYNTAX 


CHECKSUM = option 
Option is one of YES, NO, ASK. 
Default is CHECKSUM =ASK. 
NO 
Doesn't validate CHKSUM; without data checks. 
YES 


Validates CHKSUM for each file copied. If a CHKSUM is bad, flags 
the file with an error and does not copy that file. 


ASK 


Validates CHKSUM for each file copied. If the file has a bad 
CHKSUM, asks for permission (OK) to copy the file. 


DISKPOS 


Belongs to the Destination Optionlist. 


Specifies the section of the disc where the file manager is to start 
allocating new files. 


SYNTAX 


DISKPOS =n 
1<ns 32 


COMMENTS 


Ensures that certain files are located as close as possible to the low 
addresses on the disc to speed up file access. If this option is not 
specified, file space is allocated starting at the end of the previous 
allocation. Valid only for a copy to disc. 
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Miscellaneous DRWUPDAT 
Options (Continued) 
Belongs to the Command Optionlist. 


Specifies the drawing update process for the COPY command. Can only 
be used with the COPY command. See COPY command for more infor- 
mation. 


SYNTAX 


DRWUPDAT = option 
option is either FIRST or ASK. 


FIRST 


Searches the Source for a part that matches the specification. The 
first part found is updated and the copy then terminated. 


ASK 


Searches the Source for all parts matching the specification. Each 
time a part is found, you are asked if it is OK to update it. The OK 
response updates the part and then looks for the next one. Any other 
response just looks for the next part. 


LIST 
Belongs to the Command Optionlist. 


Lists the name of each file processed after it has been successfully 
processed. 


SYNTAX 


LIST = option 
option is one of LONG, SHORT, NO. 
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Miscellaneous 
Options (Continued) 


Default is LONG. 


LONG 


Lists the name of the file being copied from; the type of the copy 
(COPIED for disc-to-disc, SAVED for disc-to-tape, RESTORED for 
tape-to-disc, DELETED for files deleted, CONVERTED for the 
CONVERT/CONVERB commands); and the resulting (written to) file. 
This is a three-line message. 


NO 


Does not list any of the processed files. 


SHORT 
Only lists the name of the original file. 
COMMENTS 
lf an error occurs while a file is being copied, it is not listed. This listing is 
only used when files are physically copied, moved or deleted. May also 


be used when files are printed on the HARDEV only. 


The listing produced by this option is responsive to the P and U toggles. 


NEWCHAR 
Belongs to the Destination Optionlist. 
Restores files whose names may contain illegal characters. 
NEWCHAR’s primary use is in easing the movement of files from O/S 
earlier revisions. 


SYNTAX 


NEWCHAR 
or 
NEWCHAR =c 


c is any legal filename character. 
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Miscellaneous Default is NEWCHAR. 


Options (Continued) 
NEWCHAR =c automatically turns on the LIST =LONG option. 


NEWCHAR 


Automatically replaces all illegal characters in the filename with the 
specified character. FUTIL attempts to restore this file with the 
newname. Errors are handled normally. 


NEWCHAR =c 


FUTIL prompts for a valid replacement filename. Should the proposed 

name be invalid, FUTIL continues to ask for a replacement until a 
_ good one is entered. The file is then restored under the new name. 

If ) is entered in response to a prompt, FUTIL indicates that the file in 


question is in error. The file is not restored, and FUTIL goes on to the 
next file. 


NEWDATE 
Belongs to the Destination Optionlist. 


Specifies that the new file is to have the current date and and time as the 
creation date. (This is the system date.) 


SYNTAX 
NEWDATE 
COMMENTS 


The OLDDATE option retains the original date and time of the original 
file. (OLDDATE is the default.) 
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Miscellaneous NOARCHIV 
Options (Continued) 
Belongs to the Command Optionlist. 


Deactivates file archiving (see ARCHIVE option). May be used anywhere 
that ARCHIVE is allowed. 


SYNTAX 
NOARCHIV 

COMMENTS 
If specified with COPY, COPYTEXT, ADD or ADDTEXT; NOARCHIV 
remains in effect for subsequent ADD or ADDTEXT commands until a 


new ARCHIVE option is specified. 


Once ARCHIVE has been specified, NOARCHIV does not turn off the 
special exit processing needed for archiving. 


NOPROTECT 
Belongs to the Destination Optionlist. 


If the destination is the disc, indicates that files are to be assigned the 
task default protection group. 


If the destination is magnetic tape, indicates that the protection is not 
saved at all with the files. 


SYNTAX 
NOPROTECT 

COMMENTS 
Automatic for copying from SAVFIL/RSTFIL format tapes, because 
protection can not be retained for that format; and for any other formats 


or devices that do not support protection. 


Default only for disc-to-disc copies. 
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Miscellaneous NOSHIFT 
Options (Continued) 
Belongs to the Destination Optionlist. 


Indicates that all lowercase text is to remain as lowercase in the course 
of the copy or print. 


SYNTAX 
NOSHIFT 
COMMENTS 


Confirms the normal state of affairs. The SHIFT option is used to 
indicate that there is to be conversion from lowercase to uppercase. 


OLDDATE 
Belongs to the Destination Optionlist. 


OLDDATE specifies that the new file is to have the same creation date 
and time as the original file. 


SYNTAX 
OLDDATE 
COMMENTS 


NEWDATE gives the new file the current system date as its creation 
date. 
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Miscellaneous PROTECT 
Options (Continued) 
Belongs to the Destination Optionlist. 


Indicates that the destination files have the same protection group as 
Original files. 


SYNTAX 
PROTECT 
COMMENTS 
Default setting except for: 


e SAVFIL/RSTFIL format tapes, and all other devices that don’t sup- 
port protection. (Can’t be protected atall). 
e Disc-to-disc copies. (Default is NOPROTECT.) 


FUTIL tapes created with the PROTECT option have the same protec- 
tion checks as disc files. 


REPLACE 
Belongs to the Destination Optionlist. 


Establishes conditions for overwriting existing file with new version. 
REPLACE is valid for commands whose Destination is disc (file 
manager). 


SYNTAX 
REPLACE = option 
Option is any one of: YES, NO, ASK, NEWER, ASKNEWER. 


Default is ASK. 
YES 

Always replace old file with new version of file. 
NO | 

Never replace old file with new version of file. 
ASK 

Ask user if OK to replace old version of file with new version. 
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NEWER 


Replace only if new file exists and has a creation date subsequent to 
that of an old version of the file. 


ASKNEWER 
Combines NEWER and ASK. 


If new file has a later date, ask if it is OK to replace the old version. 


SRCHLIM 
Belongs to the Source Optionlist. 


Sets limits for the file search method. Under certain conditions, there 
may be several files with the same filename. SRCHLIM specifies how 
these duplicate filenames are to be handled. 


SYNTAX 
SRCHLIM = option 


option is FIRST or ALL. 
Default is FIRST. 


FIRST 


Only searches for the FIRST occurrence of the specified filenames. 
Terminates the current command as soon as all of the specified files 
are found; or when the search medium is exhausted, even if all the 
specified files have not been located. 


ALL 


Continues to search for specified files until the search medium has 
been exhausted; for magnetic tape, until EOF; for disc, until the 
primary catalog is completely traversed. 
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Miscellaneous 
Options (Continued) 


FUTIL/SYSTEM 
INTERACTIONS 


Response to 
System Toggles 


SHIFT 
Belongs to the Destination Optionlist. 


Indicates that all lowercase text is to be converted to uppercase in the 
course of the copy or print. 


SYNTAX 
SHIFT 
COMMENTS 


In most cases, the line-printer handler does the case conversion 
automatically (for printing only). 


NOSHIFT turns off this option. 


FUTIL does not respond normally to system print toggles (AP and AU). 
The response to these toggles is determined by the following situations. 


e Syntax and execution error messages print on the task COMDEV unless 
the SELECT NOECHO command has been used. These messages also 
go into a HARDFILE if one Is active. The 4U toggle is completely 
ignored. The/AP toggle directs the messages to the HARDEV if it is tog- 
gled on. 


e File listing messages do respond to the toggles. The LIST option defines 
their content. 


They are of the type: 


X 
COPIED TO 
Y 


or 
X DELETED 


Text printed with the PRINT, LIST and LISTTEXT commands responds 
normally to both toggles; unless directed to the Destination device :LP. 


Text printed with the PRINTLP and LISTLP commands does not 
acknowledge any of the toggles. 
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Working Directories 


Interrupt Handling 
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If enabled, working directories remain in effect for FUTIL commands. They 
can be temporarily disabled, however. To disable a working directory for a 
file or command specification, prefix an equal sign (=) to the catalog 
name. 


e To disable a working directory for the Source catalog, prefix the equal 
sign to the Source catalog name. Likewise for the Destination catalog. 


e The equal sign is not allowed in the Filenamelist. 


e |f either the Source or Destination is the implied SYSCATLG, use an 
equal sign without a catalog name. 


e During execution, the equal sign NEVER prints out as part of the file 
name; this includes listing (LIST option), the LIST command, and error 
messages. 


Examples using the equal sign (=) with a working directory: 
COPY =PCC :MT Copies disc catalog PCC to PCC on tape. 


COPY PCC=:MT Copies the subcatalog PCC from the work- 
ing directory catalog to PCC on tape. 


LIST =//LEVEL=1 Lists the first level of SYSCATLG. 


LIST =//LEVEL=1 Lists the first level of the first working direc- 
tory catalog. 


COPY : = Copies the working directory catalog to 
| SYSCATLG. 


FUTIL accepts standard system interrupts (<ESC>-Q, <ESC>-N, 
<ESC>-K). In addition, the one-line or page print (<ESC> -1, 1....) 
works when output is directed to the HARDEV or COMDEV. These inter- 
rupts are detected at all points during command execution except com- 
mand entry and tape file initialization searches (looking for the new file 
specified as :MTn). 


Once the interrupt is detected, activity related to the command stops; 
open files are closed; and the current open destination file is deleted. 
Cleanup is performed before the the next input prompt. For example, if 
you request a check pass, it is performed on the files just saved on 
magnetic tape. 


Interrupt Handling 
(Continued) 


Error Handling 


NOTES 
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Illegal Characters 
in Filename 


FUTIL 


The information and drawings contained herein are the sole property of Computervision 
Corporation. Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
express written consent of Computervision. 


Whether FUTIL returns to the O/S prompt (n>) or its own 
internal prompt (#) depends upon the current execution mode (internal 
command or O/S command). Both the ESC-K interrupt and the AC AC 
task abort cause an immediate return to O/S command level without any 
cleanup. 


If an error occurs during command execution, only files actually being pro- 
cessed are affected. Although the error is detected and an error message 
printed, FUTIL goes on to process the next file in the series. If several 
errors occur in short order without a successful copy in between, FUTIL 
aborts the current command as though in response to <ESC>-Q. 


Error messages are printed on the task COMDEV unless the SELECT 
NOECHO command has been used. 


Errors that demand an operator response always wait for a response from 
the COMDEV. The response cannot come from an execute file. 


FUTIL accepts input from standard execute files. However, 
under certain conditions, FUTIL demands input from the task COMDEV 
even if an execute file is currently running: 


e Any message requesting a TYPE OK, for whatever reason, waits for 
that OK to be typed in from the COMDEV. This includes the cases 
where FUTIL asks whether or not an existing file can be replaced, or 
asks if a file with a bad checksum should still be copied. 


e Syntax errors expect all command line corrections from the 
COMDEV. 


e When you create multi-reel tapes, you are expected to indicate at the 
COMDEV that the subsequent reels are mounted and ready to 
continue. 


CGOS 200 GNA allows any of the following characters in a filename: 0-9, 
A-Z, , #, $, %, +.-, and &. Pevious versions of the O/S supported addi- 
tional filename characters. This change complicates restoration of files 
created on earlier systems. When FUTIL encounters illegal characters in a 
filename, it asks you to enter a complete new name. 


Alternatively, the NEWCHAR option can specify replacements for illegal 
characters. 
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Illegal Characters Because FUTIL does not permit specification of illegal characters in a 
in Filenames filename, you must specify the filenames without the illegal characters. 
(Continued) There are several ways in which this can be done: 


e Use the NLEV or SUBCAT options (with the ASK option if not all the 
files are wanted). 


e Use wildcards in place of the illegal characters in the filename(s). 


¢ Do a LIST of the tape to get the tape record numbers of the desired 
files and then restore the files by record number instead of name. 


MAGNETIC TAPE FUTIL supports ANSII standard tape labels and two different formats for 

FORMATS system disc file backup tapes. SAVFIL/RSTFIL format tapes are compati- 
ble with the CGOS 100 and earlier operating systems, and the FUTIL for- 
mat tapes are for foreign tape formats for data transportation to and from 
other CGOS 200 GNA systems. 


In addition, FUTIL supports a fixed-record, fixed-block tape format (called 
Blocked Tape Format) to access tape made on other systems. 


Data Formats Blocked Tape Formats 


Blocked tapes are magnetic tapes with a special format. They move infor- 
mation back and forth between CV and non-CV systems. 


A blocked tape reel contains a series of data files. Each file is terminated by 
one tape mark. Each file consists of a series of fixed size data blocks. Each 
data block contains a number of fixed size records. 


The size of the data blocks is described in bytes; 8-bit bytes for 9-track tape 
and 6-bit bytes for 7-track tape. Data blocks must contain even number of 
bytes because of hardware constraints on CV tape drives. The minimum 
number of bytes in a block is 2 and the maximum is 8192. 


When blocked tapes are created by FUTIL, each word is broken up into 
two bytes so that only 4096 words can be written in a block. When blocked 
tapes are read by FUTIL, bytes are packed two to a word. Each byte from 
the tape is right-justified zero-filled into its appropriate byte in a word. 
7-track tapes use the least significant 6 bits in a byte. 7-track tapes are 
assumed unpacked. 
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Data blocks may be further broken up into records. It is assumed that the 
number of bytes in a record evenly divides the number of bytes in a block. 
The difference between blocks and records is that a block is a physical 
entity on the tape but a record has only a logical existence. Data records 
on the tape are left-justified zero-filled for binary tapes and left-justified 
blank-filled for text. 


There are two varieties of blocked tapes, labeled and unlabeled. The 
labeled tapes have ANSI standard tape labels in addition to to the data and 
unlabeled tapes contain only the blocked data. 


FUTIL Format Tapes 


FUTIL has a standard backup tape file format. File manager files on disc 
are copied to tape in a special backup format. All commands that deal 
with magnetic tape expect this format, unless otherwise specified. Any 
number of tape files may be stacked on reels of tape. Backup file format 
is: 


e An HDR label group 


e A sequence of file manager file images. Each file image consists of: 
— An IDREC data block(similar to the FUTIL IDREC block) 
— The file data in 10 (hex) sector blocks (1000 hex words) 


e An EOF label group 


If the backup file is split between reels, the split occurs between two file 
manager file images. No file manager file image is ever split between 
reels. 


Like disc files under file manager control, tape files are access protected. 
SAVFIL/RSTFIL Format Tapes 


FUTIL also supports the older SAVFIL/RSTFIL format backup tapes for 
CGOS 100 O/S compatibility. SAVFIL files live on so-called stacked 
tapes. A stacked tape is a series of files, each one consisting of: 


e A special header block unique to the type of file format. (Types 
other than SAVFIL are unknown.) 


e A series of file manager file images. Each file image consists of: 
— An |IDREC block (similar to the FUTIL IDREC block) 
— The file data in 10 (hex) sector (1000 hex words) blocks 


¢ Two terminating tape marks. The last file on the stacked tape is ter- 
minated by three tape marks. | 
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A tape label is an 80 character record. The first three characters are the 
label type (name) and the fourth character is the label number. Label types 
are VOL, HDR, EOV, and USR. Numbers range from 1-9. 


Tape labels provide standardized information about the contents of a reel 
or reels of tape. They also help to control access to a reel of tape. 


LABEL GROUPS 


Labels come in label groups. 


e The HDR label group precedes a file or file section. It consists of (in 


FILES 


order): 


VOL1-VOL9 (only if it is the first label group on the tape reel) 


HDR1-HDR9 
USR1-USR9 


It is terminated by one tape mark. 
Only the VOL1 and HDR? labels are necessary. 


The EOF label group terminates a file or file section. It consists of (in 
order): 


EOF1-EOF9 
USR1-USR9 


It is preceded by one tape mark and, if a HDR label group follows, 
terminated by one tape mark. The last label group in the file set is 
terminated by at least three tape marks. 


The EQOV label group replaces the EOF label group if the last file on 
the reel continues onto another other reel or if the file set continues 
onto another reel. It consists of (in order): 


EOV1-EOVY (replaces the EOF1-EOF9 labels) USR1-USR9 


It is preceded by one tape mark and terminated by at least two tape 
marks. 


A file is preceded by an HDR label group and terminated by an EOF label 
group. 
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FILE SECTIONS 


A file section is caused by the split of a file across two or more reels of 
tape. Every file section is preceded by an HDR label group. All file sections 
of a file are terminated by an EOV label group except the final section, 
which is terminated by an EOF label group. 


FILE SETS 


A file set consists of several files numbered in sequence and may be con- 
tinued across several reels of tape. Whenever a file is continued onto a 
new reel of tape, the last file on the old reel of tape is also continued 
(i.e., terminated with an EOV label group). In that case, the first file sec- 
tion on the new reel may be empty (an HDR label group followed by a 
tape mark followed by an EOF label group). 


REQUIRED LABELS 


lf a tape format includes ANSII labels, the following tape labels are sup- 
ported and required. 


VOL1 


The first record on a reel (volume) of tape. It identifies the reel 
and who can access it. 


~ HDR1 


The first record of a tape file or tape file continuation. Identifies 
the file, position of the file in its file set, whether or not this sec- 
tion of the file is continued from another reel, the system the file 
was created under, and whether there is general access. 


EOF1 


The last record of a tape file. Contains the same information as 
the HDR1 label for that file plus the physical data block count of 
that portion of the between it and the immediately preceding 
HDR label group. 


EOV1 


Same as the EOF1 label except it indicates that the file is con- 
tinued on another reel. 


In addition, the USR1-USR9 labels are supported. The USR1 and 
USR2 label are reserved for future use and the USR3-USR39 labels 
consist of user defined text. 
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Generates an execute file. The execute file is generally constructed by pro- 
cessing one or more catalogs. You control the format for processing these 
catalogs. 


GENCOM filename 


GENCOM creates a text file named filename. The structure and content of 
this file is based on: the file specification, the header lines, trailer lines, and 
command skeletons. 


n> GENCOM Filename At O/S level, enter command and 
: name of execute file. 


ENTER HEADER LINES Terminate header lines with empty 
line. 

ENTER COMMAND SKELETONS Input accepted until empty line 
entered. 

ENTER FILE SPECIFICATION " GENCOM responds with this 


prompt after all command 
skeletons have been entered. 


ENTER TRAILER LINES Output when all file specifications 
are entered. After an empty line, 
GENCOM prompts for a one- 
character response indicating one 
of several actions: 


F = FILE, E = FILE & EDIT, 
X = FILE & EXECUTE, Q = QUIT, 
S = FILE & SUBMIT, <CR> = LOOP 


Ifa ) is entered instead of a character, GENCOM repeats the entire round 
of prompts, appending the newly-generated results to the existing con- 
tents of the execute file. 


Building the 
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GENCOM prints a series of prompts to guide you through the process of 
creating the execute file. These prompts call for specific kinds of input: 


ENTER HEADER LINES 


Header lines are copied literally to the execute file. They are inserted at the 
beginning of the file, or before each series of commands on multiple loops 
through GENCOM. 


ENTER COMMAND SKELTONS 


Command skeletons control the format of the command lines. They con- 
sist of TEXTSTRINGs and NAMESPECs. 


e TEXTSTRING 


A textstring is string of characters to be included literally in each com- 
mand line generated for the execute file. TEXTSTRINGs are terminated 
by NAMESPECs or end of line. 


Example: COMPILE $1, —1, —2$/LIST AU AP 
(TEXTSTRINGs = “COMPILE” and “/LIST AU AP”). 


e NAMESPEC 


Place the NAMESPEC where the filename is to appear in each line of the 
execute file. The NAMESPEC acts as a mo/d that ensures a uniform for- 
mat for filenames that appear in the execute file. By processing the 
NAMESPEC, GENCOM selectively includes/excludes particular catalog 
levels of each filename. 


NAMESPEC Syntax:  $Start,End,Skip$ 


Start, End, and Skip are positive or negative integers that identify 
levels of a catalog or filename (any or all of the three may be 
omitted): 


Start = Starting level (Default = 1) 
End = Ending level (Default = — 1) 
Skip Skip level (Default = 0) 
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Building the | For the NAMESPEC, filenames are numbered as follows: _ 

Execute File ° 

(Continued) Catalog Levels name1.name2.name3...... nameN 
Positive Numbering 1 2 , er ree N 


Negative Numbering —-N -—-N+1—-N+2...... — 
Positive (negative) integers identify levels from left to right (right to left). 
SAMPLE $1,-1,-2$ Includes all levels between top catalog (level 1) and file- 
NAMESPECs name (level —1), except for next to last level (level —2), 


which is typically the &BCD level of a text filename. 


$2,- 1$ Includes all levels between level 2 and the filename. No 
3 intermediate levels are skipped. 


ENTER FILE SPECIFICATION 


It accepts ONE file specification of the following form, processes it, then 
waits for another. 


Catalog Name/Name List/Options 


Catalog Name Catalog from which filenames will be extracted to 
generate execute file commands. 


Name List Files in catalog Catalog Name to process. If omitted, 
all files in Catalog Name will be processed. 


Options /NLEV Process all sub-catalogs of 
Catalog Name. 


TYPE=n Only process type n files. 


SINCE | date Only process files since date. 
BEFORE date Only process files before 
date. 


As each file specification is entered, resulting filenames are applied to the 
command skeleton, producing finished command lines. 
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Example 
Generates an execute file to print files in SPECIAL catalog on HARDEV. 


n> GENCOM PRNTEFILE ) Create Execute File named 


“&BCD.PRNTFILE”. 
FILENAME IS ALREADY : 
IN USE. TYPE OK TO Output if the file ‘“&BCD.PRNTFILE” 
REPLACE EXISTING FILE? already exists. 
OK } 
ENTER HEADER LINES 
. No header lines. 
ENTER COMMAND SKELETONS 
PRINTLP $1,-1,-28 Command skeleton. 
; 
ENTER FILE SPECIFICATION 
SPECIAL//NLEV,TYPES } 
PRINTLP SPECIAL.SUBRS Output from GENCOM. All text filenames 
PRINTLP SPECIAL.GEN-X from the catalog named SPEC/AL have 
PRINTLP SPECIAL.ENTPNTS been added to the execute file. 


PRINTLP SPECIAL. TEST 


ENTER FILE SPECIFICATION 


) 


ENTER TRAILER LINES 


) 


F = FILE, E = FILE & EDIT, X = FILE & EXECUTE, 
Q = QUIT, S = FILE & SUBMIT, <CR> = LOOP 


F} 


n> Back at O/S level. 
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Converts text files to RDOS-readable format on tape in order to produce 
microfiche listings of these files. 


GENFICHE 
GENFICHE prompts you for input of the following form: 


# CATALOG Specifies that all text files in this catalog are to be 
converted to RDOS-readable format. 


# CATALOG/FILE1,FILE2,FILE3,...... »FILEN 


Specifies that only those text files in file list of 
this catalog are to be converted to RDOS- 
readable format if they exist. 


#FILE.E Specifies that this text file is to be converted to 
RDOS readable format if it exists. 


# ) When entered, GENFICHE ends file process and 
returns you to system level. 


Scans a source file to generate an index of entry points, globals, or 
subroutines. 


GENINDX ENTPNTS,GLOBALS,SUBRS[/OPTIONS] 


ENTPNTS Entry points associated with each file. 
GLOBALS Global variables and file references. 
SUBRS Subroutines referenced by each file. 


See CGOS 200 GNA Programmer Reference Manual for additional infor- 
mation 
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Outputs information about parity in data to a specified punch paper tape 
device. 


GETPUNCH XX 


Where XX = two-character taskunitname for device that’s been attached 
and declared PPTDEV. 


UNIT IS SET TO PUNCH Output upon successful command completion. 
Parity information follows. 


Any other message indicates an error. 


See SETPUNCH for list of available data parities. 
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Routes (spools) all output that can be sent to the COMDEV or HARDEV to 
a text file. 


HARDFILE {filename/option} 


The default option is: 


Create a filename: ‘“SPOOL.date.user-name.time”’ 

If filename is present, all HARDEV output is sent to text file of that name. 

Filename IS THE HARDFILE Response when a HARDFILE its created. 

FILENAME CLOSED Printed when filename and/DEFAULT option 
not present. A file open for HARDFILE out- 
put is closed. 


Note 


A task may have only one HARDFILE open at 


a time. 

ALREADY HAVE HARDCOPY FILE Filename command issued when a hardcopy 
file is already open. 

NO HARDCOPY FILE HARDFILE command with no _ filename; 
issued when no hardcopy file is open. 

FILE ALREADY EXISTS Output if a file of the same name as the 

TYPE OK } TO OVERWRITE filename exists. } causes it to be overwritten. 
Any other response will abort the HARDFILE 
command. 

ILLEGAL OPTION An option not defined is specified. 
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Prints a large character header on the HARDEV or COMDEV. 


HEADER [/Option1,...,OptionX] 


Option: LP — Print output on HARDEV also. 
NOCM -— No output on COMDEV. 
XQT — Allow input from execute files. 


When no options specified; input on COMDEV and output on COMDEV 
only. 


INPUT — Three text lines (lines may be blank). 
OUTPUT — Header on the HARDEV or COMDEV. 


e The command prints the following information twice: 


System date/time, and task user name/number. 


e Three lines of LARGE characters where the character size of the first line 
= 21 x 18; character size of lines two and three = 7 x 9. 


e If header is called from an EXECUTE file without the XQT option, the 
task waits for your input from the COMDEV. 
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HELP 
PURPOSE Prints documentation on your COMDEV. 
SYNTAX HELP 


To Access HELP 


n>HELP ) Type HELP } in response to a prompt at the Operating 
System (O/S) level (n>). Documentation is printed on 
your COMDEV. 

?] While the HELP program is running, a ?] asks for your in- 


put. Respond with document name, sub-category, or a 
special command (see below). 


A )} in response to the ?] exits HELP and returns to O/S 
level. 


e Levels 


HELP uses multiple levels of documentation to explain various O/S 


features. 
HELP (level 0) 
yo N 
/ 1 \ 
/ { \ 
name sname2 ramet (level 1) 
/ / 
/ / ‘ 
name3 names: name7 (level 2) 
/ \ 
/ \ 
sname6 name8 (level 3) 
| = 
/ l \ 
name9 name10 name11 (level 4) 


Each name (name2, name4, named, name6) may have a text document 
and further sub-category levels beneath it. Terminating names (name1, 
name3, name7, name8, name9, name10, name11) are documents 
without further sub-categories. 


From any level, only documentation at lower levels can be referenced. 
To get this documentation, type the name of the document in response 
to the ?]. If the name typed has further sub-categories, you are moved 
to the next level. If the name is a document with no further sub- 
categories, you remain at the same level. 
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e To List Documents 


From level 0 (HELP), 


the following commands enable you to access the 


documents described. 


Command 
name 


name2 


name4 named. 


name2 name3. 


e Examples 


Description 
Name! printed; you remain at level 0. 


Namez2 printed; you go to level 1; the next level 
(name3) is listed for your choice of documents. 


Named printed; you go to level 2; and documents 
at the next level (name6, name§8)are listed. 


Name3 printed; you remain at level 0 (name3 has 
no sub-categories). 


These commands, in response to the level OQ HELP prompt ?], will access 
the documents described. 


~ Command 


?] INFO DEVICES 


?] COMMAND LIST 


Description 


Prints information about system devices; you 
remain at level 0. 


Prints information about the command LIST; 
you remain at level 0. For information on any 
O/S level command mentioned in this manual, 
just type: 


n> HELP COMMAND Commandname } in re- 
sponse to the O/S prompt. 
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® Special Commands 


Several commands make accessing documents more convenient. Type 
these commands in response to the ?] prompt instead of a name: 


/L 

/B 

/R 

/O 

/S and /A 
/S 
/A 

HELP 


Lists the sub-categories and documents at the current 
level. 


Backs up one level and lists the sub-categories and 
documents at that level. 


Repeats the last text document printed. 
Leaves HELP to return to the O/S. 


HELP has two sets of documentation; system documen- 
tation and other (CADDS, user, etc.) documentation. 


Places you at level 0 of System documentation (the level 
of initial access to HELP). 


Accesses the alternate set of documentation, and puts 
you at level 0. This alternate set includes everything but 
System documentation. Type S to return to System 
documentation. 


Prints this document. 


Accesses HELP and prints on-line documentation on HARDEV. 


HELPLP [OPTIONS] 


HELPLP invokes HELP. See HELP command documentation. 
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PURPOSE 
SYNTAX 


INPUT/OUTPUT 
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Performs arithmetic operations on hexadecimal or decimal numbers. 


HEXCALC 


n> HEXCALC ) 


Base Changes 


Command sets its accumulator to zero, 
sets its base to hexadecimal, and 
responds with a prompt(#). 


Type a base change or number in the 


current base (optionally preceded by a 
unary and/or binary operation). 


Unary Operations 


T Change base to decimal. None Plus 
S Change base to hexadecimal. + Plus 
~ Minus 
% Compliment 


Binary Operations 


Addition 

Signed multiplication 
Signed division 

Modulo 

Logical and 

Logical or 

Exclusive or 

Unsigned multiplication 
Unsigned division 


Number input is modified according to 
unary operators provided, if any. Binary 
operation is applied to the accumulator; 
modified input is stored in the 
accumulator. 
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= XXXX HEX 


= XXXXXX DEC 


RESULT: 


= XXXX HEX,D 
= XXXXXX DEC 


The accumulator is typed out this way if 
current base = hexadecimal. 


Accumulator typed out this way if cur- 
rent base = decimal. 


Respond with another number with 
operators; a base change; or a) to 
terminate. 


HEXCALC’s output of the resultant 
accumulator. 


You may exit from HEXCALC with ), or 
start another sequence of calculations. 


HEXFP 
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HEXFP 

PURPOSE Translates hexadecimal representation of a floating point number to its 
floating point representation. 

SYNTAX HEXFP XXXX,YYYY 
Where XXXX = first word of hex representation of a floating point 
number; YYYY = the second word. 

COMMENT HEXFP outputs the floating point representation of the number and 


returns to the system. 
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Tests system |/O handlers. Desired values for the following may be 
entered from the COMDEV: ARGLIST, BUFFER, and CTRLBLK (for 
executing the system I/O calls READ, WRITE, and CONTROL. In addition, 
TIS input can be dumped onto the COMDEV. 


The following commands may be input from the COMDEV. The prompt is 


an asterisk (*). 


* DAN,M = HEXDUMP ARGLIST(N) - ARGLIST(M) 

* DBN,M = HEXDUMP BUFFER(N) - BUFFER(M) 

* SAN,M = SET ARGLIST(N) TO THE VALUE M 

* SBN,M = SET BUFFER(N) TO THE VALUE M 

* SUXX = SET TASKUNITNAME TO THE ASCII CHARACTERS ‘XX’ 

*SWM_~ = SET CTRLBLK TO VALUE M (BIT 0 IS HIGH ORDER) 

. BITOON = SPECIAL RETURN | 
ERROR VAL RETURNED IN CTRLBLK(1) 

= BITOOFF = NORMAL RETURN 

. ERRORS GO TO SYSTEM ERROR 
HANDLER 

- BIT 15ON = NOWAIT I/O 

. BIT 15 OFF = WAIT I/O 

* XC = E:E CONTROL.(UNITNAME,ARGLIST,BUFFER,CTRLBLK) 

* XR = E:E READ.(UNITNAME,ARGLIST,BUFFER,CTRLBLK) 

wa? 3 = HEXDUMP NEXT TIS INPUT FROM UNITNAME 

* XW = 


E:E WRITE.(UNITNAME,ARGLIST, BUFFER,CTRLBLK) 


The following messages are output at the COMDEV: 


INVALID UNIT 


WAIT I/O F:N = XXXX 


Output If unit specified in SU command is not the 
taskunitname for a device attached to this task, or, 
if an |/O call is attempted before a valid unit is 
selected. 


At the completion of an IOCALL, one of the 
following messages is printed on the 
COMDEV: 


Where XXXX = HEX value function re- 
turned by the 1/0 call. 
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MESSAGES NO-WAIT 1/0 F:N =XXXX Where XXXX = HEX value function re- 

(Continued) turned by TESTIO. Note: Period (.) is printed on 
the COMDEV each time a GIVEUP is executed 
while waiting for |/O call to terminate. 


SPECIAL ERROR RETURN CTRLBLK(1) = XXXX 
Where XXXX = error number generated by the 
1/O call. | 


If no input is received from currently specified unit 
within 5 seconds after the XT command is input, 
the following message is printed on the COMDEV: 


TIME OUT 
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Outputs current administrative and local news, for purposes of onsite user 
notification. It is automatically invoked by logging in. 


Local news. is input by editing SYSNEWS.LCLNEWS. 
LCLNEWS 


Control automatically returns to system level if there is no local news. 


LIST 


PURPOSE 


SYNTAX 


NOTE 


Lists the content of disc catalogs or magnetic tapes. 


LIST [/Options] 


[Catalog[/[Filenamelist] [/Options]]] 


[Catalog[//Options]] 
Example 
n> LIST CAT1//LIST =DT ) 


FILENAME 


CAT1.&BCD.SUBCAT2 
CAT1.SUBCAT1.&BCD.FILE1 
CAT1.SUBCAT1.&BCD 
CAT1.SUBCAT1.FILE1 
CAT1.SUBCAT1.FILE2 
CAT1.SUBCAT1.FILE3 
CAT1.SUBCAT1.SUBSUBCAT.&BCD.FILE 
CAT1.SUBCAT1.SUBSUBCAT.FILE 
CAT1.SUBCAT1.SUBSUBCAT 
CAT1.SUBCAT1 
CAT1.SUBCAT2.&BCD.FILE 
CAT1.SUBCAT2.&BCD 
CAT1.SUBCAT2 

CAT1 


DATE 


03/05/80 
01/03/80 
11/14/79 
01/03/80 
05/24/80 
05/23/80 
08/08/80 
08/08/80 
08/08/80 
05/22/79 
12/29/79 
12/29/79 
12/29/79 
11/13/78 


TIME 


11:44:29 
13:24:27 
09:22:12 
14:15:33 
15:30:22 
13:15:52 
14:14:14 
14:14:16 
14:14:12 
17:49:32 
10:21:02 
10:20:59 
10:20:58 
18:03:46 
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LIST 


LIST is a FUTIL subcommand as well as an O/S level command. The 
FUTIL section contains additional documentation. (See the FUTIL Over- 


view or the Index under FUTIL, LIST.) DELETE. 
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FILE FORMAT 


COMMENT 
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Lists all exisiting catalogs or files with the same name on a Graphics Net- 
working Architecture (GNA) system. 


LISTALL <option> Command String 
Example 
n>LISTALL <REFERENCE.FILE>MYCATALOG//SINCE =2-15-81 


This command sets up and executes a file that lists any catalog or file in 
MYCATALOG created since 2-15-81 on Networking Nodes 0, 1, 2 and in 
the directory MYDIRECTORY. 


The entered command string must be valid relative to the FUTIL LIST 
command. 


Users may set up their own reference file to control what Networking 
nodes or directories are searched. The optional reference file is listed on 
the command line delimited by ““<" and “>”. 


The reference file is a text file that includes the nodes or directories to be 
searched, each on a line by itself. 


Example 


REFERENCE.&BCD.FILE 
4-22-81 16:41:03 
1![0] 
2!(1) 
3! [2] 
4IMYDIRECTORY 


LISTALL will incorporate a command string into a file. The file will then list 
all cases of the command string according to networking nodes or direc- 
tory names listed in a reference file setup by the System Manager. This 
default reference file is named: SYSTEM.&BCD.LISTALL. 


LISTCMTB 
PURPOSE 


SYNTAX 


MESSAGES 


LISTCMTB 
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Lists contents of a file manager command table. 
LISTCMTB Filename 


Filename = Name of existing COMMTAB file. 


Command table filename, date/time of file creation, and COMMTAB en- 
tries are listed. 


For normal entries: 


_COMMAND FILE CORE CORE START 
NAME DLOC COUNT LOC LOC 


CORE IMAGE FILE NAME 
For cross-referenced entries: 


COMMAND REFERENCED + OFFSET 
NAME COMMAND NAME 
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LISTCOM 

PURPOSE Prints all active command tables. 

SYNTAX LISTCOM [FULL] 

OUTPUT When full option not used, listing includes command name only. 
Full Option Used 
Listing for normal entries includes: 


COMMAND DISC CORE CORE START PROT COM OVLY 
NAME LOC COUNT LOC LOC GRP TAB FNAM 


Listing for each cross-referenced command includes: 


COMMAND CREF COM + DISPLACEMENT 
NAME NAME 


Single character identifiers under COM TAB heading indicate the com- 
mand's origin: 


SYSCOMMAND TABLE 

SYSTEM FM COMMAND TABLE (SYSCMTB) 
Commands that are hardcoded into the system. 
SYSTEM COMMAND TABLE 
USERCOMMAND TABLE 


cCor.nd 
tot We ou il 


COMMENTS _ © If no USERCMTB is assigned, no user command table is output. 


e If SYSCMTB is empty, no system file manager command table is 
output. 
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LISTDIR 


PURPOSE Lists working directory for a task. The directory must be currently enabled. 


SYNTAX LISTDIR 


COMMENT A working directory is a user-defined search list for files referenced by the 
task. To enable a working directory, use the ENABDIR command. 


Example 


n>ENABDIR JOC=G,SYSCATLG=L ) 
DIRECTORY ALREADY EXISTS 
TYPE OK TO OVERWRITE 
OK) 
DIRECTORY ENABLED 
n>LISTDIR ) 
CREATE CATALOGS ARE: 
GLOBAL: JQC 
LOCAL: SYSCATLG 
1)JQC 
2)SYSCATLG 


MESSAGES NO TASK BASED DIRECTORY Printed when directory is currently disabled. 
IS ENABLED FOR THIS TASK 


CREATE CATALOGS ARE: If directory is enabled, lists catalogs where 
GLOBAL: catalog name files will be created. 
LOCAL: catalog name 
1) catalog! These catalogs will be searched in this order 
2) catalog2 when the file manager searches for an 
m3 existing file. 


3) catalogn file. 
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PURPOSE 


SYNTAX 


NOTE 


LISTPROT 


PURPOSE 


SYNTAX 


OUTPUT 


NOTE 
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Searches a text file for commands that reference other files. From these 
command references, a list of files is created and output to a file or the 
COMDEV. Optionally, LISTLOAD can generate a system command for 
each file referenced. 

LISTLOAD Output filename/KEYWORDSI, OPTIONS] 


Refer to the CGOS 200 GNA Programmer Reference Manual for additional 
information. 


Lists contents of disc catalogs, or magnetic tapes. LISTLP is like LIST 
except that output always goes to the line printer. 


LISTLP[/Options] [Catalog[/[Filenamelist] [/Options]]] 
LISTLP is a FUTIL subcommand as well as an O/S level command. The 


FUTIL section contains additional documentation. (See the FUTIL Over- 
view or the Index under FUTIL, LISTLP.) 


Outputs a formatted listing of a your active access table and default pro- 
tection group (DPG). 


LISTPROT 
USER USERNAME 


LINE#. Start of range — end of range/attributes. 


DEFAULT PROTECTION GROUP: XXXX 


Refer to the appropriate section in the CGOS 200 GNA System Manager 
Guide for more information on the Protection Facility. 


LISTTEXT 


PURPOSE 


SYNTAX 


NOTE 
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LISTTEXT 


Identical to the LIST command except that it processes only text files. 


LISTTEXT [/Options] 


[Catalog[/[Filenamelist][/Options]]] 


[Catalog //Options]] 


Example 


n> LISTTEXT CAT1//LIST=DT ) 


FILENAME 


CAT1.&BCD.SUBCAT2 
CAT1.SUBCAT1.&BCD.FILE1 
CAT1.SUBCAT1.&BCD 
CAT1.SUBCAT1.SUBSUBCAT.&BCD.FILE 
CAT1.SUBCAT2.&BCD.FILE 
CAT1.SUBCAT2.&BCD 


DATE 


03/05/80 
01/03/80 
11/14/79 
08/08/80 
12/29/79 
12/29/79 


TIME 


11:44:29 
13:24:27 
09:22:12 
14:14:14 
10:21:02 
10:20:59 


LISTTEXT is a FUTIL subcommand as well as an O/S level command. The 
FUTIL section contains additional documentation. (See the FUTIL Over- 
view or the Index under FUTIL, LISTTEXT.) 
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LOADLIB 
PURPOSE Creates a load library. 
SYNTAX LOADLIB catalog.name [OPTIONS] 


NOTE Refer to CGOS GNA Programmer Reference Manual for further informa- 
tion. 
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Moves a file from the CGOS file system to the specified PCU for (optional) 
execution. 


LOADPCU TASKUNITNAME, FILENAME, STARTOPTION 


TASKUNITNAME Task name for the PCU. 


FILENAME = Name of file to be loaded into PCU. 

STARTOPTION = Specifies whether PCU is to start executing 
downloaded program. Lists starting address, If 
appropriate (see examples below). 

Examples 

n> ATTACH PC,PCOO } This downloads 

n> LOADPCU PC,OVLY,PCU.TEST ) OVLY.PCU.TEST into 


PCOO; PCU starts execution 
at start address specified in 
OVLY.PCU.TEST. 


n> LOADPCU PC,OVLY.PCU.TEST,100 } Functions like previous ex- 
ample except that PCU 
starts executing at location 
100 (HEX). 


n> LOADPCU PC,OVLY.PCU.TEST,* ) Like previous examples 
except that PCU does not 
start executing downloaded 
program. 


You must attach the PCU to be loaded using the ATTACH command, 


before running the LOADPCU command. The contents of FILENAME 
should be in MOSTEK format. (See Engineering Specification for PCU). 


Terminates a task. 
LOGOUT 


All units attached to the task are unattached and the task is terminated. 
(See LOGOUT and Autologout Procedure, Section 2.) 
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Manipulates text files. Like EDIT, LONGEDIT is a line-oriented editor that 
prompts for text-processing commands. LONGEDIT has a more limited 
command syntax than EDIT, but it can handle lines of up to 256 


characters. 


LONGEDIT filename [,N][/MODE,CNT1,CNT2] 


OPTIONS N 


MODE 


CNT1 


CNT2 


Open a new file. Generates an error if filename 
exists. 


Either D or F; designates line length formats for 
the COMDEV and for output (printer or other 
interactive devices): 


D Display mode; allows you to set COMDEV 
line length. Output line length will always 


be 72. 

F Format mode; allows you to set line 
lengths on the COMDEV and output 
devices. 


Display record character count. The number of 
characters that appear on each line of the 
COMDEV. 


File record character count. The number of 
characters that appear on each line of the output 
device (line printer or other peripheral). If MODE 
is set to F, CNT2 defaults to a length of 256. 
When MODE is D, CNT2 will always be set to 
72, regardless of the value input on the com- 
mand line. 


If MODE is omitted from the command line, 
character counts default to 72. 


Caution 


Editing an existing file with a new, shorter file 
record character count will cause each edited 
line to be chopped off at the new line length. 
Any characters beyond the new line length will 


be lost. 


INPUT/OUTPUT 


LONGEDIT 


The information and drawings contained herein are the sole property of Computervision 
Corporation. Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
express written consent of Computervision. 


Once the file is open, the # prompt indicates that LONGEDIT is ready to 
accept commands. To end the session and return to O/S level: 


F ) saves the work. 
Q } terminates without saving any changes. 


e Examples 


To create the file CAT.FILE using a COMDEV record length of 50 and an 
output file record length of 100: 


n> LONGEDIT CAT.FILE,N/F,50,100 ) 
_ FORMAT MODE 

DISPLAY RECORD LIMIT = 50 

OUTPUT FILE RECORD LIMIT = 100 

# 


To edit the existing file CAT.FILE using a COMDEV record length of 25: 


n> LONGEDIT CAT.FILE/D,25 
DISPLAY MODE 

DISPLAY RECORD LIMIT = 25 

OUTPUT FILE RECORD LIMIT = 72 

# 


When Display mode or Format mode is chosen, MODE and record 
length parameters are always echoed on the COMDEV. 


e Line Numbers 


~ Most LONGEDIT commands process lines or sequences of lines. Lines 
are represented by decimal line numbers. Line numbers internal to the 
editor; they are not physically represented in the the file being edited. 


— Any command that accepts a range of lines will also accept a single 
line. 


— When a line number beyond the end of the file is given as a command 
argument, LONGEDIT substitutes the last line number of the file. 
This is true for every command except D (Delete), which will 
generate an error if a line number argument exceeds the last line. 
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— Insertion lines are forced into the range of one to the last line of the 
file. 


— With insertion commands (C,I,M, and X) a destination line of 0 in- 
serts text before the first line of the file. 


e Renumbering 
— Certain LONGEDIT commands automatically renumber the file: 


T (TYPE LINES) 

L (LOCATE LINE) 

S (SUBSTITUTE TEXT) 
A,F (FILE CHANGES) 


— Text inserted or modified after renumbering is not available for 
inspection (or modification) until another renumbering command is 
issued. 


— The message, EDIT BUFFER IS FULL is output when a great deal of 
text has been modified without renumbering. To continue editing, 
issue one of the renumbering commands. 


— An error or ESC QO entered from the keyboard can interrupt the 
execution of many LONGEDIT commands. This type of interruption 
does not affect text already modified. Reissue the command to 
modify any remaining text. When an error interrupts command 
execution, LONGEDIT will indicate the extent of buffer modification 
prior to the error. 


¢ String-Oriented Commands 


L and S are string-oriented commands. They search the file, or portions 
of the file for a particular sequence of characters (a string). There are 
two types of strings, Word strings and normal strings. 


— Word strings are limited to alphanumeric characters. When a word 
string is specified in an L or S command, the string will only be 
recognized within text if it is surrounded by special characters, 
blanks, or line boundaries (end-of-line, beginning-of-line). In the L 
and S command syntax, word strings are represented literally; 
delimiters are not allowed. 
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Alphanumeric Characters 


The characters 0-9, and A-Z are alphanumeric. No special characters 
are alphanumeric. 


— Normal strings can be composed of any characters. A normal string 
need not be surrounded by special characters when it occurs in text. 
When used in an L or S command, however, a normal string must be 
surrounded by a pair of matching delimiters. 


e Delimiters 


In string search syntax, any special character except a space or an & can 
function as a delimiter. 


¢ Sample String Search 


n> LONGEDIT JPR.SAMPLE Opens the file for EDITING; T file’s 
#T 1!1 SAW 1DOG AT THE ZOO 

2!11DOG WAS MARCHING COMent 

3IHERE’S 1D0G; A HOTDOG, 

411 SAW 21D0GS TODAY 

5ITHERE ARE NO DOGS HERE 

6!HERE IS 1DOGGIE 

7!1 SAW1DOG ON THE STREET 


L,1DOG Word string search for lines con- 
111 SAW 1D0G AT THE ZOO taini ; 
211D0G WAS MARCHING aining string, 7dog 
3IHERE’S 1DOG: A HOTDOG 


L,/1DOG/ Normal string search for lines con- 
1!1 SAW 1DOG AT THE ZOO faint tri 
SHRGG Whe WRECKING aining string, 7dog. Note changed 
3IHERE’S 1D0G: A HOTDOG, results. 


411 SAW 21D0GS TODAY 
6!IHERE IS 1DOGGIE 
7!| SAW1DOG ON THE STREET 


¢ Commands 
( } must terminate all commands.) 
A SYNTAX A catalog.file 
Files changes in an auxiliary file. The buffer is written to 
catalog.&BCD.file (this name Places the modified file from the 


current session in ‘‘catalog.&BCD.file,’’ which must not have the 
same name. “A” does not terminate LONGEDIT. 
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C 


SYNTAX C linea [—lineb], linec 


Copies specified lines. Inserts a copy of the block from linea to 
lineb after linec. 


SYNTAX D linea [ —lineb] 
Deletes specified line(s). 
SYNTAX E line [/columna [—columnb]] 


EDITS a line between specified column positions. This special 
command modifies single lines character by character. The sec- 
tion to be EDITED ts between columna and columnb. If neither 
columna nor columnb is specified, the whole line is EDITED. It 
columna only is specified, the line is EDITED from columna to 
line’s end. 


Delimited characters are typed out without the line number; the 
CRs to the first column under this line, and modification 
characters are entered under specific characters to be modified. 
Columns beyond the end of this line act like trailing spaces and 
may be modified just like any other character in the line. Modifica- 
tion characters affect the character under which they appear. 


e Modification Characters 


Space No effect; retains old character. 
AN Blanks out old character and turns it into a space. 
\ Deletes old character. 

Note 


Valid characters may be deleted when \ is 
used to delete spaces beyond the end of the 
line. 


[ Inserts all characters following the [ before the old 
character; including all modification characters 
described here except J. 
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] Terminates insertion started by [. Acts like a normal 
character unless it follows [ insertion. 


) Terminates modification instructions and types the 
line with requested modifications. Also terminates 
insertion started by [. 


Other Any other characters will replace existing 
characters. 


Modifications may be entered after ] terminates an insertion 
started by [. Although additional modifications begin with the 
character that [ appears under, they are not aligned with the 
modification line owing to the [] pair and any intervening 
characters. 


Once } terminates the modification instructions, a modified line 
is typed out without a line number and may be further modified. 
Characters in the line that follow the )’s position are modified as 
if spaces had been typed beneath them, i.e., they remain the 
same. 


) at the beginning of the modification line terminates “’E.” 
F SYNTAX F 


Quits and files all changes. Terminates LONGEDIT and files text 
modifications. Changes from the current session become a per- 
manent part of the file. 


| SYNTAX | [line] 


Inserts text after line. If line omitted, text will be inserted before 
line 1. 


L SYNTAX L{linea [ —lineb]], string 


Locates lines containing string. Searches the line or range of lines 
for specified text string. If a line contains one or more occurrences 
of the string, LONGEDIT types the line preceded by its line 
number. If no line numbers are specified, the whole file is 
searched. 
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M SYNTAX M linea [—lineb], linec 
Moves specified lines. Identical to the sequence: 


C linea [—lineb], linec 
D linea [ —lineb] 


If linec is not specified, linea-lineb will still be deleted. 
N SYNTAX Nn 


Allots n spaces at the start of the line for a line number. 
Whenever LONGEDIT lists a line, it prefixes the current line 
number to the text. This line number is separated from the body 
of the line by an exclamation point (!). n is the number of digits 
(including the exclamation point and leading spaces) that the 
line number can occupy. If the digits in a line number exceed n, 
only the right hand digits will be printed. The default spacing for 
line numbers is 6. 


Q SYNTAX Q 
- Quits without filing changes. Control returns to the O/S. No 
changes from the EDITING session are filed. This is really a user- 
abort of the EDITOR. 
R SYNTAX R linea [ — lineb] 
Replaces specified line(s). R linea [—lineb] is equivalent to: 
D linea [ —lineb] 
| linea 
Caution 
R linea [—lineb] will delete linea [—lineb] 
regardless of whether replacement lines are 


entered. Once R has been typed, the deletion 
cannot be revoked. 
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S SYNTAX S [linea [—lineb]], stringa, stringb 


Substitutes one text string for another. Searches for stringa; 
replaces stringa with stringb. Within the line range, every occur- 
rence of stringa is replaced, including multiple occurrences within 
a single line. Each time a substitution is made, old and new 
versions of the line are typed out. If no lines are specified, the 
whole file is searched. 


Note 
Do not include leading spaces in stringa or 
stringb. 
T SYNTAX T [linea [ —lineb]] 
Types lines. If specified, linea through lineb will be listed. If lineb is 
omitted, linea through the end of the file will be listed. T with no 
line numbers will list the entire file. LONGEDIT renumbers the file 
before typing requested lines. 
X SYNTAX X catalog.file, linea [ —lineb], linec 
Extracts lines from external file. Copies linea through lineb from 


file catalog.&BCD.file; places them after linec in the file being 
EDITED. 
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Moves files from one device, catalog, or file to another. 


MOVEI/Options] 
[Catalog[/[Filenamelist] [/Options]]] 
[Catalog| //Options]] 


Caution 
Moving a file to itself deletes the file. 

e MOVE is identical to the COPY command, except when the operation is 
on disc files. In that case, the original source files are deleted upon suc- 
cessful completion of the copy. 

e MOVE is a FUTIL subcommand as well as an O/S level command. The 


FUTIL section contains additional documentation. (See the FUTIL Over- 
view or the Index under FUTIL, MOVE.) 
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Examines or modifies files. 
PACHFILE CATALOG.FILE 


Where CATALOG.FILE is the file to be patched. 


n> PACHFILE ) Enter command along with Catalog.file. 
# System prompts, indicating that it is waiting for a 
command. 


e Buffer Management Commands 
OFFSET OFFSET [or OF] =val 


Establishes an offset to the start of the buffer. The first 
word in the buffer will have an address of val (base 16). 


FILESIZE FILESIZE [or FS] 


System responds with file size in hex words. In the 
following commands, all occurrences of the word 
locn, where n is a decimal digit, represent buffer 
addresses in the range: 


OFFSET < locn <= FILESIZE —1 
e Buffer Examination Commands 


DUMP DUMP [ locn ] [ locn ] 
D [loc1-loc2], [loc1-loc2],... 


Dump prints (in hex) all values between loci and loc2. 
When no ranges are specified, entire file is dumped. 
Output format is: 


loc! XXXXK XXXXK XXXK XKKXK KKXKK KKKXK 
locl +8 | 
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INPUT/OUTPUT SEARCH SEARCH [ loc ] [ loc ] 
(Continued) SR [loct-loc2], [loc1-loc2],... = value 


SEARCH prints buffer locations within a specific range 
whose contents equal value. When no range is given, 
the entire buffer is searched. Output format is: 


loc! value 
loc2 value 


e Buffer Modification Commands 
SET SET [or SE] loc = value1,value2...,valuen 


Sets the contents of buffer locations loc to loc+n1 to 
values value1, value2,...,valuen. 


SET [ loc ] [ loc ] 
SE [loc1-loc2] [loc1-loc2],... = value 


Sets the contents of buffer locations (within specified 
ranges) to value. 


MOVE MOVE [or M] count,loc1,loc2 


Moves a portion of the buffer. Count words are moved 
from loci to loc2. 


WRITE WRITE [or W] loc1,...locn = /insert string/ 


WRITE sets buffer contents literally; the actual string 
characters, not ASCII values are inserted at each loc. 
The string fills the next n/2 words, (n = number of 
characters in the string). Any special character can be 
used to delimit the string; use the same character to 
begin and end the string. | 


e Miscellaneous Commands 
SUM SUM [or SU] loc1-locn 


SUM adds values of consecutive words in the buffer. 
SUM only produces single-precision results. 
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e Terminating Commands 
FILE FILE [or F] 


FILE writes buffer contents back to original disc loca- 
tion. File reflects all buffer content changes. When the 
file is re-written, control returns to O/S. Note: 
PACHFILE does not have a quit command; all changes 


must be filed. 
BAD COMMAND PACHFILE does not recognize command. 
BAD LOCATION Buffer address being examined or modified is outside 


permitted address range. In commands specifying 
ranges: if either end of a range is beyond the buffer 
limits, command is not performed for that range. When 
multiple ranges are specified: command is performed for 
all ranges that satisfy the boundary check. 


NEGATIVE RANGE Upper bound of a range pair is less than the lower 
bound. 


see DUMPFILE. 
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Puts a pause within an execute file where you want the system to wait. 
PAUSE is used for requesting tapes to be mounted and other operator 
action. Execution resumes when you enter a valid response. 


PAUSE _ [OPTION 

OPTIONS MAX = X X = minutes the system will wait for your 
response. If no response Is made, the task is 
logged out. Default = 60 minutes. 


Responses from COMDEV: 


CONTINUE Resumes execution. 


. _ Same as CONTINUE. 
NOBELL Supresses output of audible tone every 10 seconds. 
QUIT Kills the execute file and returns to system level. 


Execution of the execute file either continues or exits. 
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Patches PCU overlay files. 


PCUPCH CATALOG.FILE [,RELDLOC,|[,BASE]] 


CATALOG.FILE 


RELDLOC 


BASE 


n> PCUPCH ) 


BASE 


DUMP 


FILE 


File to be patched. 


Sector displacement from beginning of file where patch- 
ing is to start. 


Base location assigned to first word of file’s patched 
portion. 


The default for both RELDLOC and BASE is zero. 


Enter command. PCUPCH then reads that portion of the 
file that is to be patched into core. 


System response. You may input any of these 
commands: 


[= NEWBASE] 


(>0) is the new value to be given to BASE. If 
= newbase is present, BASE assigns the new value to 
base. Otherwise, the command outputs the current 
value to base. 


HEX-BOUNDS-LIST 


HEX-BOUNDS-LIST is a list of locations to be dumped 
of the form: 


XXXX1 [YYYY1],...,XXXXn [—-YYYVYn] 


in which XXXX1 (and YYYY1) must be greater than or 
equal to BASE. The specified locations are dumped 
from the overlay file. In the DUMP, ASCII characters: 
‘R’, ‘L’, ‘N’ represent the ASCII characters carriage 
return, line feed and null, non-printing characters. 
These characters cannot be changed. 


Writes the patched portion of the Overlay file to the disc 
file. PCUPCH terminates. 
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FILESIZE 


PACHSIZ 


Q 
SET 


SETLOC 


Outputs the total sector count for the file. 


Outputs the number of words in the portion of the file 
being patched. The number of words in the portion of 
the file being patched is either the number of words in 
the file remaining beyond the REDLOC, or the size of 
the core image buffer for PCUPCH, whichever is 
smaller. The core image buffer size for PCUPCH is the 
address of the taskunitname table for the task minus 
“SEOO'x. 


Terminates PCUPCH without filing. 
SETLOC = VAL1...,VALN (N15) 

A hex location greater than or equal to BASE. 
VAL1...,VALN 


A list of ASCII values to be placed in SETLOC and loca- 
tions following SETLOC. The given values are placed in 


the specified locations of the overlay file. Then the 


checksum of the modified record is recalculated. 
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Modifies a text file by removing all text lines identical to the preceding line. 
PRGCOPY FILENAME 
FILENAME Name of the text file to be processed. For example, 


n> PRGCOPY HELP.SUBRS ) 


n> 


Prints text files on a COMDEV or HARDEV. The system printing toggles 
(AP and 4U) direct output. Files other than text files cannot be printed 
with PRINT. 


PRINT[/Options] 
[Catalog[/[Filenamelist] [/Options]]] 


Example 

Prints text file CAT1.SUBCAT1.&BCD.FILE1 on COMDEV. 
n> PRINT CAT1.SUBCAT1.FILE1 ) 
CAT1.SUBCAT1.&BCD.FILE1 ) 


1-8-81 22:14:35 


(Contents of file) 
(are listed here) 
n 
PRINT is a FUTIL subcommand as well as an O/S level command. The 


FUTIL section contains additional documentation. (See the FUTIL Over- 
view or the Index under FUTIL, PRINT.) 
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Prints text files on a HARDEV. If there is no HARDEV, types out an error 
message and stops. PRINTLP ignores the system printing toggles ( AP and 
AU). PRINTLP will not print files of other types, since &BCD is assumed 
as the next to last level of the filename. 


PRINTLPI/Options] 
[Catalog[/[Filenamelist] [/Options]]] 


Example 
Prints contents of text files in CAT1.SUBCAT1 on line printer. 


n> PRINTLP CAT1.SUBCAT1//LEVEL=1 ) 


CAT1.SUBCAT1.&BCD.FILE1 (PRINTING) 
CAT1.SUBCAT1.&BCD (PRINTING) 
CAT1.SUBCAT1.SUBSUBCAT&BCD.FILE (PRINTING) 


PRINTLP is a FUTIL subcommand as well as an O/S level command. The 
FUTIL section contains additional documentation. (See the FUTIL Over- 
view or the Index under FUTIL, PRINTLP.) 


Lists and prints job parameters of a job in the system BATCH queue. 
Job Parameters 

Priority 

Status of each job step 

Name of submitter 


PRNTJOB Jobname 


Jobname Name of the job (20 character maximum). 
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Assigns a new taskunitname to an already attached unit. 
RENAMDEV Oldname, Newname 
Oldname = Current two-character name for attached unit. 


Newname = _ New user-selected two-character name assigned to this 
unit (see ATTACH). 


Control returns automatically to system level. 


UNIT NAMED OLDNAME changed to NEWNAME. Renaming 
successful. 


NEW NAME ALREADY 
IN USE 


BAD REQUEST OLDNAME is bad. 


Renames a file or a catalog. 


RENAME CATALOG.OLDFILE,NEWFILE 


OLDFILE = _ File or catalog to be renamed. 
NEWFILE = _ New file or catalog name to be assigned. 
Example 


n> RENAME MANUAL.SECTION-7, Type to rename the file 
SECTION-S ) MANUAL.SECTION-7 to 
MANUAL.SECTION-S8. 


FILE RENAMED System response. 
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Renumbers the statement numbers in a FORTRAN source program and 
formats code within DO loops. 


RENUMBER catalog.file 


Refer to CGOS 200 GNA Programmer Reference Manual for additional 
information. 
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Positions a tape at the load point. 


REWIND [TAPENAME] 


REWIND 


TAPENAME User-assigned taskunitname for the tape unit (see 


ATTACH). 


BAD TASK UNIT NAME Specified taskunitname 
exist in system. 


does not 


TAPE UNIT NOT ATTACHED Tape unit is not attached. 


Reads into core and executes an overlay file. 


RUN FILENAME {, arguments for overlay} 


The filename argument is mandatory. Arguments are relevant only to a 
particular overlay. The overlay must have been created with the loader 


using a CWRITE statement. 

RUN ASSUMES: 

Core location = starting location. 

Priority switch & highest allowable priority = 0. 
DLC = 0. 


Or 


Filename with arguments for overlay. © 


Filename as overlay file in catalog SYSCOMMAND, with the form 


equivalent to: RUN SYSCOMMAND.NAME. 
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Selects task parameters. 


SELECT OPTION [,OPTION...] 


OPTIONS - 


LP = OFF No line printer task to be dispatched. If printer 
already dispatched, you must finish current file 
and logout. All print toggles output to spool files © 
for later printing. 

LP=ON Line printer task may be dispatched. All print 
toggles output to spool files. 

LP=KILL Stops printing, deletes current file, logs out. 

LP = QUIT Stops printing, logs out, does not delete current 
file. 

LP =WAIT Stops printing. Waits for further instructions. 

LP = RESTART Restarts printing of current file from beginning. 

LP = CONTINUE Continues printing current file from current line. 

LP = DELETE Deletes current file, continues printing files in 


BATCHMAX=N 


BATCHCM( = N) 


queue. 


Sets N as maximum number of concurrently 
executable BATCH tasks. | 


Selects your monitor device as unique unit N. 


BATWAIT=S Selects number of seconds BATCH processor 
will wait for user. 

UPPRCASE Converts all lower-case characters to upper- 
case. 

LOWRCASE Enables lower-case characters to be typed. 

BACKGRND Puts task into background priority CPU queue. 
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FOREGRND[=N] 


ECHO 
NOECHO 


TIME 


NOTIME 


NOFORM 


DOFORM 


ERRLEVEL = VALUE. 


XXXDEV = YY 


Puts task on specified (N,N=1-3) CPU queue 
(default of CPU Queue 1). 


Sends all output to COMDEV. 
Suppresses all COMDEV output. 


Enables command timing, outputting time taken 
by last command executed. 


Disables command timing. 


Disallows form-feeds (page-ejects) on hard copy 
device (HARDEV). 


SYNTAX NOFORM 


Allows form-feeds (page ejects) on hard copy 
device (HARDEV). 


DOFORM = default at LOGIN time. (Used only 
after you disables normal processing of form- 
feeds by means of NOFORM. 

SYNTAX DOFORM 


VALUE can be long, normal, or short. Subse- 
quent error messages follow accordingly. 


XXXDEV declares attached unit as task specific 
device, and YY as its TASKUNITNAME. 


SYNTAX XXXDEV = TASKUNITNAME 


(XXXDEV can = CARDEV, COMDEV, HARDEV, 
PPTDEV, or RPTDEV) 


TASKUNITNAME = _ two-character,user- 
assigned name for attached unit. 


3-203 


SELECT 


MESSAGES 


COMMENT 


SET 
PURPOSE 


SYNTAX 


3-204 


The information and drawings contained herein are the sole property of Computervision 
Corporation. Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
express written consent of Computervision. . 


TASKUNITNAME IS XXXDEV Taskunitname successful. 

BAD REQUEST Taskunitname is bad. 

TASKUNITNAME IS NOT XXXDEV If declaration is successful, previ- 
ously declared XXXDEVS are unde- 
clared. 


Control returns automatically to system level. 


Sets user task memory locations to given values. 
SET LOC = Vall, Val2, .. .,ValN 


Sets: LOC = Vall 


LOC + 1 = Val2 


LOC + N-1 = Valn 
Example 
n> SET 100=0 )} Typed to set core location 100(hex) to 0. Location 


100(hex) is set to zero. Control returns to command 
level. 


Caution 
SET should only be used for extraordinary 


O/S debugging. SET is capable of destroying 
irrecoverable system and disc data. 
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Changes current user’s default protection group (DPG). 


SETPROT [PG]. Any combination RWEDCM or S, G, or P. Filename may 
be a full filename or a catalog name. 


PG = (Protection group) where a and b represent HEX 
numbers in the range 0000 — 7FFF. 

S,G,P = Default designators. (System, Group, Private). 

RWECDM = Attributes of PG range: Read, Write, Execute, Delete, 


Change, Modify. 


Whenever a file/command is created, a default protection group (DPG) is 
assigned automatically. SETPROT enables you to write files/commands in 
any protection group to which you have write access. 


To Specify DPG: 

1. State desired DPG as a hex number (range 0000-7FFF). 

2. Input a default designator (System, Group, or Private) with desired 
combination of attributes. This input is compared to your current 
access table. When identical attributes exist there, the PG number 
takes the place of the one initially assigned to the DPG. You must 


then list the new DPG in your access table as a PG with write access. 


3. At each Login, the DPG is automatically assigned as stated in the 
Authorize file regardless of the last SETPROT. 


Example 
USER ACCESS TABLE 
2000-2001/RWDS 
2006-2006/R 
2009-200A/RWD 
Command New DPG 
n> SETPROT 2006 } ERROR-NO WRITE ACCESS 


n> SETPROT 2010 ) 2010 
n> SETPROT SRWD } 2000 
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Allows user-selected parity for data output to a punch paper tape device. 
The device must be attached to task and be declared a PPTDEV. 


SETPUNCH PARITYCOM 


PARITYCOM = One of the following parity selection commands: 


NOPARITY (Transparent data transfer) 
ODD 

EVEN 

MARK 

SPACE 


PARITY SET Command successfully completed. 


ERROR Command in error. 


Changes parity and pack options on a tape unit. 
SETTAPE TAPENAME, PAROPT, PACKOPT 


TAPENAME User-assigned task name for tape unit (see ATTACH). 


PAROPT 0 = Odd parity. 

E = Even parity. 

~PACKOPT N = Unpacked. 
P = Packed. 


The following are the default values for PAROPT and PACKOPT when a 
tape unit is attached: 


7-track drives 9-track drives 
PAROPT 0 0 
PACKOPT P U 


Control returns automatically to system level. 
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Sorts a catalog; filenames are alphabetized by ASCII value. 
SORTCAT [CATALOG] 
SORTCAT sorts all subcatalogs of a specified catalog to N levels. 


SYSCATLG is the default catalog. In this case, all catalogs on any enabled 
auxiliary volumes are sorted. Note that SYSCATLG can only be sorted ina 
single user mode. 


Using TASKILL to abort a SORTCAT is not recommended; it may leave 
some catalogs task-protected. Should catalogs become task-protected, 
use FMCLEAR catalogname (on same task the SORTCAT was performed) 
to clear them. 


CANNOT SORT SYSCATLG WITH More than one task is active when 
ae aL you tried to sort SYSCATLG. 
ONLY FIRST xxx NAMES IN Catalog contains more than 700 


The latter entries remain in original 
order. 


Caution 


Working directories must be disabled prior to 
executing SORTCAT. 
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Sorts a text file under file management. 
SORTFILE FILENAME [/OPTION1,...OPTIONn] 


FILENAME = Name of file manager file to be sorted. 


OPTIONS 

CASE Sorts upper-case and lower-case characters as if 
they were identical. | 

FIELD [=BEGIN,COUNT] Selects field within a line 


upon which each line is sorted. Characters are 
numbered starting at zero. The default field, if 
this option is not specified, is the first eight 
characters in each line (BEGIN =0, COUNT =8). 


MRGCOPY [=BEGIN,COUNT] If the sort pass generates 
- multiple lines with identical sort fields, 
MRGCOPY blanks out the field in all lines except 
the first. If the MRGCOPY field is not specified, 
the default is BEGIN=0 and COUNT =8. 


PSTAT Outputs status information at regular intervals 
during the sort. 

REVERSE Sorts file in reverse ASCII order. | 

STABLE | Sorts file using a stable sort algorithm. 

Example 


n>SORTFILE A.B.C. } 


Sorts file A.B.&BCD.C according to contents of first eight characters in 
each line of file. 


n> SORTFILE A.B.C /FIELD =0,72,MRGCOPY ) 


Sorts according to contents of first 72 characters in each line. If the first 
eight characters of multiple consecutive lines are identical, duplicate first 8 
characters of each line are blanked out. 


n>SORTFILE A.B.C /PSTAT,REVERSE,STABLE ) 


Sorts file in reverse ASCII order, using a stable sort on the default FIELD; 
prints periodic sort status information. 


SRCHBCD 
PURPOSE 


SYNTAX 


INPUT/OUTPUT 


SRCHBCD 
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Locates occurrences of strings in a set of text files. 


SRCHBCD CATALOG NAME/NAME LIST/OPTIONS 

CATALOG Name of the catalog containing the files to be searched. 
NAME SYSCATLG is the default. 

NAME List of files within the catalog to be searched. If omit- 
LIST ted, the entire catalog is searched. 


Using NAME LIST in conjunction with NLEV (below) 
causes all files in subcatalogs of CATALOG NAME 
whose terminating file names appear in NAME LIST to 
be searched. 


OPTIONS (Separate with commas.) 


/NLEV Processes all levels of catalog and all subcatalogs 
with a name list, processes only those files 
whose names terminate with the NAME LIST 


option. 
NOFORM Replaces all form-feeds in SRCHBCD output 
with five line feeds. 
{SINCE Searches only those files dated since (before) the 
BEFORE} date given. This must appear as the last option in 
the list: 
{SINCE Date Time 


BEFORE} MO-DY-YR HR:MIN:SEC 


SUBCAT Interprets NAME LIST as a subcatalog list; 
assumes NLEV. 


n> SRCHBCD ) Enter command along with Catalog name, Name 
list, and desired Option(s). 


# Prompt; SRCHBCD is waiting for command. A), 
in response to prompt, or an error, exits to O/S. 


Input a string, prefixed by one of three com- 
mands: L, S, or G. 
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INPUT/OUTPUT 
(Continued) 


L Actual-string 


S, Actual-string 
G, Actual-string 


FILENAME, DATE, 
TIME 
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in whole or in part is forbidden without the 


= LCTEXT; Actual-string = actual BCD string 
surrounded by spaces. SRCHBCD echoes the 
string and proceeds to search appropriate files. A 
space ora }LF> is treated as a special character 
(not a letter, digit, or ampersand &). 


lf a <) LF> and/or space is used as a delimiter 
for the search-string, SRCHBCD recognizes all 
occurrences of ACTUAL-STRING. Otherwise, 
SRCHBCD will only recognize occurrences of 
ACTUAL-STRING that are preceded and fol- 
lowed by special characters. Use S or G instead 
of L if searching for the name of a Subroutine or 
Global. 


An S or G search examines object file(s) instead 
of text file(s). If the corresponding object file for 
a &BCD file does not exist, then the &BCD (text) 
file will be searched. If the string does not occur 
in the existing object file, the &BCD file will not 
be searched. 


Output for each file containing the string, along 
with a listing of lines in the file that contain that 
string. 


STATUS 
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STATUS 
PURPOSE Lists system status information. 
SYNTAX STATUS [OPTION — 1[, OPTION — 2[...[, OPTION-N]]]] 


e Options 
Options enable disc volume status to be printed, including: 
1. System configuration. 
2. System version. 


3. File manager status for each disc drive: 
— Logical drive number. 
— Current date and time. 
— Pack ID. 


— Creation date and time of last file manager initialization of 
volume. 


— Volume name. 
— Volume protection group. 


— Total number of sectors available for files and catalogs on the 
volume. 


— Largest number of contiguous sectors available on the volume. 
FM =VOLUME-LIST Status of indicated volumes. 
FM Status of all enabled volumes. 


FM=MI,...N] Status of volumes indicated by logical drive 
numbers M through N. 


4. Information about attached system devices: 
— Task number associated with an attached device. 
— Unique device names. 


— Device codes. 
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SYNTAX VER . System version/date. 


(Continued) DEV Info on all attachable units in the system. 
DEV=USER Info on units attached to task only. 
DEV = PPTDEV Info on PPTDEV type units only. 
DEV = RPTDEV Info on RPTDEV type units only. 
DEV = HARDEV Info on HARDEV type units only. 
DEV = COMDEV Info on COMDEV type units only. 
DEV = CARDEV Info on CARDEV type units only. 
DEV = ALLDEV Info on units of all types. 
DEV = USERCMDV Info on task COMDEV only. 
DEV = DFLTHROV Info on default HARDEV only. 


e Additional Options 


SELECT Prints COMDEV operational characteristics and information 
about associated |/O devices for your task, including: 


1. COMDEV Characteristics: 


— DOFORM/NOFORM 

— ECHO/NOECHO 

— UPPERCASE/LOWRCASE 

— Maximum CPU priority queue: 
BACKGROUND 
FOREGROUND (1, 2, OR 3) 

_ — DEFAULT ERROR MESSAGE LEVEL 

(Long, Normal, Short) 


2. Task Devices: 


— HARDEV 
— PPTDEV 
— RPTDEV 
— CARDEV 
— COMDEV 


3. Task Operation 


— COMDEV toggle. 

— HARDEV toggle. 

— HARDFILE, SPOOLING OR HARDFILE 
— Active execute files. 

— Active USERCMTB’s. 
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TASK 


STAT 


SELECT = ALL Above information for 
system user tasks. 


SELECT =N[,..m] Above information for 
listed tasks only. 


Allows you to print the following about each user task on 
the system: 


. Task number. 
. Task user name. 
. User-set text string. 
. Last user command. 
. Task status. 

— Not logged in. 

— Executing. 

— |/O WAIT. 
6. Current CPU queue: 
— FOREGROUND high, medium, low 
— BACKGROUND. 
— Use IN K words. 
— A-PORT memory. 
— B-PORT memory. 


o1fP WN — 


TASK =NI,..M] Above information and full command 
line is printed for listed tasks. 


TASK = FULL Both above information and your last 
command line. 


You may print information about the system and task 
statistics blocks: 


Task number. 

Percentage CPU time used since LOGIN. 

Percentage CPU time idle since LOGIN. 

Seconds of CPU time used since LOGIN. 

Disc reads requested since LOGIN. 

Disc writes requested since LOGIN. 

(If ***** appears, counter has overflowed more than 
32767 disc reads/writes). 


gt a ee 
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STATUS 


SYNTAX 
(Continued) 
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BATCH Lists the batch operating parameters. 


1. Maximum BATCH tasks allowed. 
2. Current count of batch tasks. 
3. Count of pending batch requests. 
4. Earliest starting time of pending batch jobs. 
5. BATCH operator counsole. 
6. Maximum time to wait for an operator. 
7. Line printer status. 
8. Count of pending line printer requests. 
ALL Prints information as though you had entered any of these 
commands: 


STATUS FM, DEV, TASK, 
VER, SELECT, STAT 


If no options are selected, the default status command is: 


STATUS TASK,VER 


SUBMIT 


PURPOSE 


SYNTAX 


MESSAGE 


SYSNEWS 


PURPOSE 


SYNTAX 


COMMENT 


SYSSIZE 


PURPOSE 


SYNTAX 


METHOD 


ERRORS 


SUBMIT 
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Adds to new or existing Batch job files: 


Single line commands 
Execute files (job steps). 


SUBMIT Filename 
Filename = name of executable file submitted to batch processor. 


BAD REQUEST Output when no filename given. 


Outputs current system news. 
SYSNEWS 


System news is input by editing SYSNEWS.SYSNEWS. Control 
automatically returns to system level if there is no system news. 


Computes the difference between the system’s physical memory capacity 
and its maximum memory usage under the current configuration. This in- 
formation is used to check whether sufficient memory ts available to 
accomodate a network task. 

SYSSIZE 


Memory availability information output. 


No error indicators. 
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TAPETYPE 


TAPETYPE 
PURPOSE 


SYNTAX 


METHOD 


COMMENT 


TEST 


PURPOSE 


SYNTAX 


MESSAGES 


COMMENT 
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Outputs information about attached tape units. 
TAPETYPE [TAPENAME] © 


TAPENAME User-assigned taskunitname for a tape unit (see 
ATTACH). : 


Information is output in this format: 


[9] » [ODD] 
MT: [] TRACK, UN PACKED, [ ] 
[7] [EVEN] 


After tape unit information is output, control is returned to the O/S. 


Checks to see whether the system is functioning properly and if disc ac- 
cess is possible. 


TEST 
** SUCCESS** Test is successful. 
‘ERROR MESSAGE There is a problem. 


Control returns automatically to the O/S. 


UP 


UP 
PURPOSE 


SYNTAX 


COMMENT 


MESSAGES 


USERCMTB 
PURPOSE 


SYNTAX 


COMMENT 


MESSAGE 
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Sends the FORM FEED command to the HARDEV. 
UP [N] 

N = Number of form feeds; default = 1. 

Control returns automatically to system level. 


COUNT MUST BE LESS Printed when N is more than 10. 
THAN 10 


Specifies a file as your command table, or indicates that there is no table. 
USERCMTB [Filename] 

Filename Names an existing user command table. 

Until you logout or execute another USERCMTB command, your user 
command table is available only to the task performing the USERCMTB 


command. 


USERCMTB with no filename argument removes current user command 
table, if any. 


USERCMTB Output after current user command table is removed. 
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Section Four 
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Section 4 
SYSTEM ERRORS 


This section lists all CGOS error codes and messages. The following chart 
lists on-line filenames, the hexadecimal range of error codes, and the 
particular type of error. Material in the chart is explicitly broken down into 
fifteen sections that relate to specific devices and commands. 


Please refer to on-line documentation if there is any question regarding the 
codes and messages. 


Software failures, though labeled as such, are sometimes caused by a 
hardware failure. Software failures can cause data problems so subtle and 
widespread as to invalidate all data on a disc pack. Consult with the 
System Manager for relevant recovery procedures. 


A list of on-line filenames and Error Message File Ranges follows. 


Error File/Error Range Error Lists 
System SYSNEWS.ERROR.SYS System error 
Error (0301-FFO7) codes/meanings. 
Device ACO Contains encoded 
Errors error description. 
(FOO6) See DUMPERR. 

SYSNEWS.ERROR.FOO6DEV Left byte error 
(0000-0012 - Devices) code descriptions. 
SYSNEWS.ERROR.FOO6TYP Right byte error 
(0001-0035 - Errors) code descriptions. 
File SYSNEWS.ERROR.FM File Management 
Management (C004-C141) error codes/ 
Errors descriptions. 
FUTIL SYSNEWS.ERROR.FUTIL.RUNNERS 
Errors (A000-A019 1/O Handler) 


(A020-A024 - Disc) 

(A030-A031 - Paper Tape & Card Reader) 
(A040-A069 - Magnetic Tape) 
(A070-A093 - Miscellaneous) 


System Errors 
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ERROR Error File/Error Range Error Lists 
LIST 
(Continued) FUTIL Errors SYSNEWS.ERROR.FUTIL.SCANERRS 

(Continued) (A180-A1B2 - FUTIL Scanner) 


SYSNEWS.ERROR.FILESCAN 
(A100-A114 - Utility) 


LOADER SYSNEWS.ERROR.LOADER.MAJOR 
(8001-8052) 


SYSNEWS.ERROR.LOADER.MINOR 
(8080-9092) 


SYSNEWS.ERROR.LOADER.DIAGNOSTICS 
(80D1-80D5) 


Others SYSNEWS.ERROR.UTIL 
(9801-980A) 


SYSNEWS.ERROR.SRCHBCD 
(8001-800B) 


SYSNEWS.ERROR.EDIT 
(8001-8014) | 


SYSNEWS.ERROR.TECO 
(8000-81 19) 


Describing The amount of information output to users when errors occur can be 
Errors modified to suit particular needs. Use the SELECT command to specify 
one of three possible information levels: 


SELECT ERRLEVEL = SHORT Error number only. 

SELECT ERRLEVEL = NORMAL Error number and a brief de- 
scription. 

SELECT ERRLEVEL = LONG The error number, descriptive 


title, and detailed description. 
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Changing Error 
Message Content 


System 
Errors 


Error messages can be adapted to meet special site requirements. The 
following printout illustrates the steps involved when error message con- 
tent is changed. 


5>EDITCMTB CMTB.FILE, N ) Command causes error 


**ERROR he ao message. Part of which is 
--FILE OR CATALOG ALREADY EXISTS 
to be replaced. 


(COPEN, RENAME) 


5>SRCHBCD SYSNEWS.ERROR//NLEV } Instruct the system to find 


SRCHBCD SYSNEWS.ERROR//NLEV the error message for C007. 
5-6-8 0:32:59 
#L, C007 Type Search command 
SYSNEWS.ERROR.&BCD.FM (locate) for C007. 

5-6-8 0:05:07 


Line of text is given con- 
ale COO taining C007; terminate with 
ESC-Q when you get data. 


# 
5>EDIT SYSNEWS.ERROR.FM ) Use Editor to change 
Aaa message. 

341 = =CO007 


35!--FILE OR CATALOG ALREADY EXISTS 
36!(COPEN, RENAME) 


38! = = C008 

39!--ATTEMPT TO DELETE A NON-EMPTY CATALOG 
#R35-36 

--COULD NOT CREATE FILE OR CATALOG; 

--FILE OR CATALOG ALREADY EXISTS 


#F 

5>EDITCMTB CMTB.FILE, N ) Retype the original com- 

“Semen mand; gets new _ error 

--COULD NOT CREATE FILE OR CATALOG; 

--FILE OR CATALOG ALREADY EXISTS ras 

SYSNEWS.ERROR.SYS 

0100 UNKNOWN FORMAT CODE (&SCNFMT) 

0101 FORMAT DOES NOT MATCH DATA TYPE (&SCNFMT) 

0103 BAD SCALE FACTOR (&FORMIN,&FORMOUT) 

0104 NESTING TOO DEEP IN FORMAT (&FORMIN,&FORMOUT) 

0105 1/O BUFFER OVERFLOW (&ONECHAR) 

0106 BAD CHARACTER COUNT FOR ALPHA FORMAT — A1 OR A2 ALLOWED (&ALPHA) 

0184 EXPONETIATION WITH BASE EQUAL TO ZERO AND WITH A NEGATIVE INTEGER 
EXPONENT 

0185 OVERFLOW FROM EXPONENTIATION WITH INTEGER BASE AND AN INTEGER EXPONENT 

0186 ARGUMENT EQUAL TO OR LESS THAN ZERO. OR EXPONENTIATION WITH BASE EQUAL 
TO OR LESS THAN ZERO AND WITH A REAL EXPONENT (ALOG, DLOG) 

0190 OVERFLOW (TAN,DTAN) 

0191 OVERFLOW IN LIBRARY ROUTINE OR FROM EXPONENTIATION WITH A REAL EXPONENT 


(EXP, DEXP,DPOWER2) 


System Errors 


System 
Errors 
(Continued) 
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UNDERFLOW IN LIBRARY ROUTINE OR FROM EXPONENTIATION WITH A REAL EXPO- 
NEMT (EXP,DEXP,DPOWER2) : 

AUGUMENT LESS THAN ZERO (SORT, DSQRT) 

BOTH ARGUMENTS EQUAL TO ZERO (ATAN1,DATAN2) 

DOUBLE INTEGER DIVISION BY ZERO, OR DOUBLE INTEGER REMAINDER MODULO ZERO 
BAD INPUT STRING LENGTH REQUESTED (TYPIN) 

HARDFILE — MORE CHARACTERS THAN BUFFER SIZE (TYPOUT) 

A PRINT REQUEST WAS DIRECTED TO THE HARDEV BUT THERE WAS NO HARDEV 
ATTACHED TO THE TASK (GLP) 

PRINT REQUEST TO UNKNOWN DEVICE REQUESTED (GLP) 

NEGATIVE STRING LENGTH 

BAD STRING LENGTH SUPPLIED (INITCHAR) 

BAD CHARACTER POINTER TO STRING (NXTCHAR) 

THE LINE BEING RESTORED WAS MEANINGLESS (RSTRSCAN) 

THE SCAN POSITION BEING RESTORED IS NOT A VALID POSITION (RSTMARK) 
AN ERROR IN THE SCAN LINE WAS DISCOVERED (REINITCH) 

TOO MANY CHARACTERS FOR A HEXADECIMAL NUMBER (HEXNUM) 

NO CHARACTERS WHERE HEXADECIMAL NUMBER EXPECTED (HEXNUM) 
CHARACTER IN A HEXADECIMAL NUMBER IS NOT A HEXADECIMAL DIGIT (HEXNUM) 
BAD BUFFER SIZE ON PACKED TAPE INPUT 

MISSING FILE NAME (CATOPT) 

MISSING SLASH (CATOPT) 

MISSING EQUAL SIGN (=) (CATOPT,SKIPEQ) 

BAD FILE TYPE (CATOPT) 

BAD DATE (CATOPT) 

BAD OPTION (CATOPT) 

MISSING COMMA (CATOPT) 

MISSING NOT-EQUAL SIGN (#) (SKIPEQ) 

MISSING EQUAL/NOT-EQUAL SIGN (= OR #) (SKIPEQ) 

NON-ALPHABETIC CHARACTER WHERE AN IDENTIFIER IS EXPECTED (IDENT) 

TOO MANY CHARACTERS IN AN IDENTIFIER THE MAXIMUM NUMBER OF CHARACTERS IS 
8. (IDENT) 

NO CHANNEL AVAILABLE (RUN) 

NOT AN OVERLAY (RUN) 

BAD START LOCATION (RUN) 

BAD CORE TOP (RUN) 

NOT ENOUGH CORE (RUN) 

MISSING FILE NAME (DQ) 

THE DO COMMAND COULDN'T FIGURE OUT WHAT TO ‘DO’ TO THIS FILE (DO) 

A DEVICE ERROR OCCURRED ON THE COMDEV OR HARDEV WHILE TRYING TO INITIALIZE 
THE PRINTER/FORMATTER (CHGPRFMT,PRINTLIN) 

UNABLE TO OBTAIN A PHYSICAL DEVICE FOR PRINTING (CHGPRFMT) 

ILLEGAL CARRIAGE CONTROL REQUESTED (PRINTLIN) 

VALUE GIVEN IS ILLEGAL FOR THE OPTION REQUESTED (CHGPRFMT) 

ILLEGAL OPTION (CHGPRFMT) 

BAD COMPUTED GOTO INDEX (&COMPGO) 

NO CHARACTERS WHERE AN INTEGER IS EXPECTED (INT) 

NON-NUMERIC CHARACTER WHERE AN INTEGER IS EXPECTED (INT) 

TOO MANY CHARACTERS IN AN INTEGER (INT) 

ALPHABETIC CHARACTER IN AN INTEGER (INT) 

ILLEGAL PAGE SLOT IDENTIFIER 

BAD TASK BLOCK POINTER (PATASK) 

ILLEGAL SYSTEM PAGE IDENTIFIER 

CALLER DOES NOT OWN THE PAGE SPECIFIED BY SPID 

ILLEGAL TYPE OF MEMORY 

NO PAGE AVAILABLE 

ILLEGAL PERMISSION (ALLOWING A READ OR A WRITE) WITH A NULL SPID 
PROTECTION VIOLATION: PAGE CANNOT BE ACCESSED AS SPECIFIED BY PERMIT 
ILLEGAL PROTECTION ATTRIBUTE 

PAGE SPECIFIED BY SPID IS IN THE CALLER’S PAGE FRAME 

INVALID TASK STATUS BLOCK (TSB) (COPYINIT, COPYBLK,COPYCLS) 

NETWORK LINK DOWN — NETWORK TASK LOGGED OUT 


System 
Errors 
(Continued) 
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D011 
D012 
D013 
D014 
D020 
D021 
D022 
D100 
D101 
D102 
D103 
D104 
D105 
D106 
D200 
D201 
D202 
D203 
D300 
F001 

F002 
F003 

F004 
F005 
F007 


F008 
F009 
FOOA 


FOOB 
FOOC 
FOOD 


FOOE 


FOOF 


FO11 
F012 


F013 


F014 
F015 
F016 
F017 
F020 
F021 
F023 
F024 
F025 


FFO2 
FFO3 
FFO4 
FFOS 
FFO6 
FFO7 


INVALID LINK ID 

UNABLE TO ATTACH PCUC DEVICE 

UNABLE TO ATTACH PCUG DEVICE 

UNABLE TO ACCESS PCU DEVICE 

INVALID DESTINATION SITE ID IN A NETWORK REQUEST 

INVALID SYS ROUTINE ID 

NO NETWORK IN CONFIGURATION 

NETWORK TASK DOWN 

PCU HARDWARE ERROR 

WORD COUNT DOESN'T MATCH 

HEADER READ TIMEOUT 

HEADER MATCH TIMEOUT 

DATA READ TIMEOUT 

WRITE TIMEOUT 

GENERAL SOFTWARE ERROR CODE (FOR NETWORK TASK) 

SEGMENT STEP OUT OF RANGE 

INVALID ECB OWNER 

BAD HEADER 

BLOCK SIZE GREATER THAN NETWORK TASK BUFFER ALLOWS 

TTY OUTPUT REQUESTED BY TASK WHICH DID NOT HAVE TTY 

TRIED TO TAPE, TREAD, TWRITE OR USE TAPE ON A UNIT WHICH IS NOT A TAPE UNIT 
BAD UNIT NAME ON I/O REQUEST 

BAD I/O REQUEST COMPONENT DOES NOT EXIST 

INVALID lIOFLAG ADDRESS 

ATTEMPT TO UNLOCK A QUEUE WHICH THE TASK DOES NOT HAVE (ACO = ADDRESS OF 
QUEUE) 

REQUIRED ACTION ON UNIT NOT ATTACHED TO TASK 

END OF TAPE 

BAD UNIT ARGUMENT IN DISC I/O CALL THIS ERROR USUALLY INDICATES THAT A 
CATALOG OR RIB SECTOR OF THE FILE MANAGER HAS BEEN CLOBBERED. 

BAD COUNT ARGUMENT OR BUFFER ADDRESS IN DISC 1/0 CALL 

BAD ARGUMENTS TO USETAPE 

TRIED TO DO LBLGO ON A BAD LABEL A LABEL IS BAD IF THE RETURN ADDRESS IS 
NEGATIVE OR THE CORE CONSTANT. 

TRYING TO DO AN RPT1 (OR PPT1 OR CARD1) WITH NO RPTDEV (OR PPTDEV OR CARDEV) 
IN THE CASE THAN THERE ARE NO RPTDEV’S (OR PPTDEV’S OR CARDEV’S) IN THE CON- 
FIGURATION, AC1 CONTAINS THE LOCATION CALLING RPT1 (OR PPT1 OR CARD1) + 1. 
EXCEED DISC AREA TOP ON A DREAD OR A DWRITE AC2 CONTAINS THE REQUESTED 
DLOC RELATIVE TO START OF TASK DISC AREA. 

INVALID TASKBLOCK POINTER FOR INTER-TASK ARGUMENT COPY (PASSARGS) 
REQUEST TO QUEUE A TASK FOR CPU THAT IS ALREADY QUEUED (ENQDQ — THIS 
ERROR DOES NOT PRINT, SYSTEM HALTS WITH F012 IN ACO) 

INVALID NEWPC ON REQUEST TO QUEUE A TASK FOR CPU (ENQDQ THIS ERROR DOES 
NOT PRINT, SYSTEM HALTS WITH F013 IN ACO) 

INVALID WORD COUNT FOR INTER-TASK ARGUMENT COPY (PASSARGS) 

GETUVAL READ PROTECTION ERROR (IODONE) 

PUTUVAL WRITE PROTECTION ERROR (IODONE) 

FATAL ERROR IN PARTIAL SECTOR (WAIT) 1/0 (SDREAD/SDWRITE) 

INVALID ARGUMENT TO SETTRACE 

INVALID ARGUMENT TO SUBTRACE 

BAD SPID IN &TRSET — E020 — 

ROLL TABLE OVERFLOW MAXIMUM NUMBER OF SUBROUTINE NESTING IS 47 
OVERLAY TABLE OVERFLOWED MAXIMUM NUMBER OF OVERLAYS IN CORE AT ONCE IS 
16 

UNDEFINED SUBROUTINE 

WILD JUMP 

WRITE VIOLATION: ATTEMPT TO WRITE READ-PROTECTED MEMORY 

ACCESS VIOLATION: ATTEMPT TO READ OR WRITE ACCESS-PROTECTED MEMORY 
INSTRUCTION VIOLATION: ATTEMPT TO DISABLE MAP FROM TASK SPACE 

DEFER VIOLATION: NINTH LEVEL OF INDIRECTION EXCEEDED 
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DEVICE This printout defines the device on which the F006 Error occurred. 
ERRORS | 

0000 MAGNETIC TAPE 

0001 DISC 

0002 TELETYPE 

0003 LINE PRINTER 

0004 iOS 

0005 NUMERIDEX 

0006 INFOTON 

0007 XYNETICS 

0008 PCUG 

0009 TERMINET 

000A PAPER TAPE READER 

000B PAPER TAPE PUNCH 

000C CARD READER 

000D PCUC 

O00E TASK BASED I/O 

0010 INSTAVIEW 

0011 GRAPHICS PROCESSING UNIT 

0012 DOT-MATRIX PRINTER/PLOTTER 
F006 TYPE This printout defines the type of error which caused the FQQ6 error. The 
ERRORS error was detected by PERROR. 

0001 CALL IS NOT A WRITE OR CONTROL 

0002 BAD LENGTH ARGUMENT (CONTROL) 

0003 BAD LENGTH ARGUMENT (WRITE) 

0004 MEMORY PROTECTION VIOLATION (CONTROL,WRITE) WHILE ACCESSING BUFFER 

0005 INVALID ARGUMENT (READ,WRITE) 

0006 BAD ARGLST(0) (CONTROL) 

0007 BAD ARGLST(0) (READ, WRITE) 

0008 BAD LENGTH ARGUMENT (READ,WRITE) 

0009 MEMORY PROTECTION VIOLATION (READ,WRITE) WHILE ACCESSING BUFFER 

000A MEMORY PROTECTION VIOLATION (WRITE) WHILE ACCESSING BUFFER 

000B MEMORY PROTECTION VIOLATION (CONTROL) WHILE ACCESSING ARGLST 

000C MEMORY PROTECTION VIOLATION (WRITE) WHILE ACCESSING ARGLST 

000D MEMORY PROTECTION VIOLATION (WRITE,CONTROL) WHILE ACCESSING ARGLST 

Q00E MEMORY PROTECTION VIOLATION (READ,WRITE) WHILE ACCESSING ARGLST 

0010 BAD LENGTH ARGUMENT (READ) 

0011 MEMORY PROTECTION VIOLATION (READ) WHILE ACCESSING BUFFER 

0012 MEMORY PROTECTION VIOLATION (READ) WHILE ACCESSING ARGLST 

0013 INVALID ARGUMENT (CONTROL) 

0014 END OF TAPE 

0155 EXCEEDED MTRECMX WHILE PERFORMING TAPE OPERATION 

0016 HARDWARE ERROR DETECTED IN TAPE I/O 


F006 TYPE 
ERROS 
(Continued) 
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0017 
0018 
0019 
0020 
0021 
0022 
0023 
0024 
0025 
0026 
0027 
0028 
0031 
0032 
0034 


0035 


COMMAND NON-EXISTENT 

TAPE 1/0 ATTEMPTED WHEN TAPE UNIT NOT READY 

ERROR IN TAPE I/O 

INPUT ABORTED WITH ERROR DETECTED 

INTERFACE SIGNALED ERROR 

DEVICE ALREADY IN USE 

GPU DID NOT RESPOND TO NIOP 

HARDWARE ERROR IN DISC !/O OR DISC IS NOT ON-LINE 

BAD DLOC ON DISC PACK 

INVALID DRIVE NUMBER ARGUMENT 

DISC ERROR NOT RECOVERABLE BY RETRIES 

DISC ERROR ON RECALIBRATE ATTEMPT 

WORDCNT OR DCH BUFFER ADDRESS GREATER THAN ‘7FFF’X (LOCKDCH) 

WORDCNT PLUS BUFFER ADDRESS GREATER THAN ‘7FFF’X (LOCKDCH) 

PERMISSION FOR PAGE NOT CONSISTENT WITH TRANSFER TYPE REQUESTED 
(LOCKDCH) 

ONE (OR MORE) OF THE PAGES ON WHICH THE DCH BUFFER RESIDES HAS A NULL SPID 
(LOCKDCH) 


FM errors are used by PERROR (SYSOV.PERROR) to output appropriate 
error message to user COMDEV. See PERROR for details of table format. 


C004 


C005 


C006 
C007 
C008 
C009 
CO0A 
C010 
C011 

C012 


C016 
C017 
C018 
C019 
CO1A 
CO1B 


CO1C 
CO1D 
CO1E 
CO1F 
C020 
C021 

C022 
C023 


C030 
C034 
C035 
C036 


C037 
C038 


CATALOG LEVEL IN COMPLETE FILE NAME IS NOT A CATALOG OR VOLUME (COPEN, 
REOPN,MOPEN, DELETE,RENAME) 

CATALOG IN COMPLETE FILE NAME NOT FOUND (COPEN,ROPEN,MOPEN,DELETE, 
RENAME) 

FILE NOT FOUND (COPEN,ROPEN,MOPEN, DELETE, RENAME) 

FILE OR CATALOG ALREADY EXISTS (COPEN,RENAME) 

ATTEMPT TO DELETE A NON-EMPTY CATALOG (DELETE) 

FILE STRUCTURE IS OFF-LINE OR DOES NOT EXIST (ALL) 

UNDEFINED FILE MANAGER ENTRY POINT CALLED (BRANCH) 

ATTEMPT TO MODIFY OR SUPERSEDE A CATALOG (COPEN,MOPEN) 

ATTEMPT TO OPEN FOR READ A FILE ALREADY OPEN FOR MODIFICATION (ROPEN) 
PROTECTION VIOLATION, FILE IS ACCESS PROTECTED (COPEN,ROPEN,MOPEN,DELETE, 
RENAME) 

FILE IS TASK PROTECTED (COPEN, ROPEN,MOPEN, DELETE,RENAME) 

FILE OR CATALOG IN USE (RENAME,DELETE) 

ATTEMPT TO WRITE ACCESS A FILE NOT OPEN FOR WRITE (FWRITE) 

ATTEMPT TO SHORT-OPEN A NON-CONTIGUOUS FILE (ROPEN) 

ATTEMPT TO OPEN FOR MODIFY A FILE THAT IS IN USE (MOPEN) 

ATTEMPT TO OPEN FOR CREATE WITH SUPERSEDE A FILE ALREADY OPENED FOR 
MODIFY OR CREATE WITH SUPERSEDE (COPEN) 

ATTEMPT TO READ PAST END OF FILE (FREAD) 

ATTEMPT TO WRITE PAST END OF FILE (FWRITE) 

ATTEMPT TO READ A NEGATIVE WORD COUNT (FREAD) 

ATTEMPT TO WRITE A NEGATIVE WORD COUNT 

NOT ENOUGH CONTIGUOUS SECTORS AVAILABLE (COPEN,CLOSE,FWRITE) 

DISC SPACE EXHAUSTED FOR NEW FILE DATA ON LOGICAL FILE UNIT (COPEN,CLOSE) 
DISC SPACE EXHAUSTED FOR NEW FILE ENTRY ON LOGICAL FILE UNIT (COPEN,CLOSE) 
DISC SPACE EXHAUSTED ON EXPANDING CLOSE ON THIS FILE UNIT FILE IS CLOSED PRO- 
PERLY, BUT WITH ORIGINAL FILE SIZE (CLOSE) 

INVALID STATUS WORD IN CHANNEL BLOCK (CLOSE) 

STATUS WORDS IN FILE ENTRY AND CHANNEL BLOCK ARE INCONSISTENT (CLOSE) 
INVALID STATUS WORD IN FILE ENTRY (COPEN,ROPEN,MOPEN) 

STATUS WORD AND USE COUNT IN FILE ENTRY ARE INCONSISTENT (COPEN,ROPEN, 
MOPEN) 

INVALID USE COUNT IN FILE ENTRY (COPEN,ROPEN,MOPEN) 

INVALID STATUS WORD, USE COUNT, OR INCONSISTENCY BETWEEN THE TWO WHEN 
CLOSING A FILE. FILE NOT CLOSED. (CLOSE) 
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CO3A HARDWARE DISC ERROR (ALL) 

C03B PUSH DOWN LIST OVERFLOW (CATWALK) 

C040 ATTEMPT TO ACCESS A CHANNEL WHICH IS ALREADY IN USE BY THIS TASK 
(COPEN,ROPEN,MOPEN) IN READCHAN/WRITCHAN 

C041 ATTEMPT TO ACCESS A CHANNEL WHICH IS NOT IN USE (FREAD,FWRITE) IN READ- 
CHAN/WRITCHAN | 

C043 ILLEGAL CHANNEL USED FOR A READ, WRITE, OR CLOSE REQUEST 
(CLOSE,FREAD,FWRITE) IN READCHAN/WRITCHAN 

C045 CHANNEL SPACE EXHAUSTED. NO CHANNEL HAS BEEN ALLOCATED. 
(COPEN,ROPEN,MOPEN) IN ALLOCHAN 

C046 ATTEMPT TO CLOSE A FILE WHICH HAS A ZERO USE COUNT AND/OR IS NOT MARKED AS 
IN-USE (CLOSE) 

C047 OWNER OF CHANNEL IS NOT THIS TASK (CLOSE,FREAD,FWRITE,RENAME) IN READ- 
CHAN/WRITCHAN 

C048 THERE ARE NO OPEN CHANNELS FOR THIS TASK (CLOSE) 

C049 ALL CHANNELS OWNED BY THIS TASK ARE MARKED AS NO-CLOSE OR ARE SYSTEM 
CHANNELS WHICH CANNOT BE CLOSED (CLOSE) 

CO04A AN ERROR HAS BEEN DETECTED IN THE DISC RESIDENT COPY OF THE FILE CHANNEL 

| DATA STRUCTURES. 

C04B AN ERROR HAS BEEN DETECTED IN THE FILE MANAGER RESIDENT COPY OF THE FILE 
CHANNEL DATA STRUCTURES. 

C050 INVALID CHARACTER IN FILE NAME (COPEN, ROPEN,MOPEN, DELETE,RENAME) 

C051 LEVEL IN FILE NAME EXCEEDS 20 CHARACTERS (COPEN,ROPEN, MOPEN, DELETE,RENAME) 

C052 NO CHARACTERS IN FILE NAME (COPEN,ROPEN,MOPEN, DELETE, RENAME) 

C053 ATTEMPTING TO CREATE A FILE WITH ZERO OR LESS SECTORS (COPEN) 

C054 FILE NAME CONSISTS OF MORE THAN ONE LEVEL OR DOES NOT TERMINATE PROPERLY 
(RENAME) 

C055 COMPLETE FILE NAME EXCEEDS 80 CHARACTERS (COPEN,ROPEN,MOPEN, DELETE, 
RENAME,CATWALK) 

C056 ATTEMPT TO USE A VOLUME SPECIFICATION WITHIN A DIRECTORY CATALOG 

C057 COULD NOT CONSTRUCT FULL FILENAME FROM DLOC AND INDEX OF FILE ENTRY 
(BUILDNAM) 

C061 INVALID ALLOCATION REQUEST (COPEN,CLOSE,FWRITE) 

C062 RIB ERROR DURING DEALLOCATION (CLOSE, DELETE) 

C070 VOLUME INFORMATION IN CORE DOES MATCH REQUESTED VOLUME (ENABVOL, 
DSABVOL) 

C071 VOLUME NAME AND FILE ENTRY ARE INCONSISTANT THIS USUALLY MEANS AT LEAST 
PART OF THE FILE STRUCTURE IS BLOWN (COPEN,MOPEN,ROPEN,RENAME, DELETE, 
XOPEN) : 

C072 VOLUME IS IN USE OR ATTACHED (DSABVOL) 

C073 DEFAULT VOLUME STARTING DLOC IS NON-ZERO (DFLTVOL) 

C074 VOLUME NAME IN PRIMARY DISC VOLUME ENTRY DOES NOT MATCH VOLUME NAME OF 
AUXILIARY VOLUME 

C075 ATTEMPT TO USE A VOLUME NAME AS A NEWNAME (RENAME) 

C076 MORE THAN ONE VOLUME LEVEL IN A FILENAME THIS ERROR USUALLY MEANS THAT AT 
LEAST PART OF THE FILE MANAGER IS BLOWN (COPEN, ROPEN,MOPEN, XOPEN,RENAME, 
DELETE) 

C077 REQUESTED VOLUME NOT ENABLED (COPEN, ROPEN, MOPEN, XOPEN, RENAME, DELETE, 
DSABVOL, DFTLVOL) 

C078 REQUESTED VOLUME ALREADY ENABLED (ENABVOL) 

C079 REQUESTED VOLUME ENABLED ON ANOTHER DRIVE (ENABVOL) = 

CO7A REQUESTED VOLUME IS IN USE AS A DIRECTORY (DSABVOL) 

C080 DIRECTORY FILE IS EMPTY (DOTXTFIL) 

C081 COUNT OF DIRECTORY ENTRIES EXCEEDS MAXIMUM (ADDTODIR) 

C082 DIRECTORY DISABLE CHARACTER NOT PERMITTED IN DIRECTORY ENTRY (ADDTODIR, 
ENABDIR) 

C083 DIRECTORY ENTRY EXISTS AND IS NOT A CATALOG (ADDTODIR) 

C084 FORMAT ERROR IN DIRECTORY ENTRY (ADDTODIR,DOTXTFIL,ENABDIR) 

C085 COUNT OF DIRECTORY ENTRIES IS LESS THAN 1 (ENABDIR,LISTDIR, WRITEDIR) 

C086 INVALID OPTION SPECIFIED (ADDTODIR) 

C087 DIRECTORY ENTRY APPEARS MORE THAN ONCE (ADDTODIR) 
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FILE MANAGER C088 DIRECTORY TEXT FILE NOT FOUND (DOTXTEIL) 
ERRORS C089 A TASK BASED DIRECTORY IS ALREADY ENABLED FOR THIS TASK 
CO8A NO TASK BASED DIRECTORY IS ENABLED FOR THIS TASK 
(Continued) C090 BAD OPTION (TSKDATA) 
C091 ATTEMPT TO OBTAIN TASK GLOBAL DATA FROM THE FM TASK (TSKDATA) 
COAO THE DISC RESIDENT VERSION OF THE CLUSTER ALLOCATION TABLE CONTAINS AN IN- 


VALID BITMAP FOR THE SYSTEM AREA OF THE DISC. THE INTEGRITY OF FILES CUR- 
RENTLY ON THE DISC IS PRESERVED. HOWEVER, NO FURTHER ALLOCATION OF DISC 
SPACE IS POSSIBLE. THIS IS A FATAL FILE MANAGER ERROR AND SHOULD BE 
REPORTED TO THE SYSTEM ADMINISTRATOR IMMEDIATELY. (GETCAT) 

COA1 THE CORE RESIDENT VERSION OF THE CLUSTER ALLOCATION TABLE CONTAINS AN IN- 
VALID BITMAP FOR THE SYSTEM AREA OF THE DISC. THE INTEGRITY OF FILES CUR- 
RENTLY ON THE DISC IS PRESERVED. HOWEVER, NO FURTHER ALLOCATION OF DISC 
SPACE IS POSSIBLE. THIS IS A FATAL FILE MANAGER ERROR AND SHOULD BE 
REPORTED TO THE SYSTEM ADMINISTRATOR IMMEDIATELY. (GETCAT) 

COA2 AN ATTEMPT HAS BEEN MADE TO ALLOCATE DISC SPACE IN THE SYSTEM PORTION OF 
THE DISC. THIS IS A FATAL FILE MANAGER ERROR AND SHOULD BE REPORTED TO THE 
SYSTEM ADMINISTRATOR IMMEDIATELY. (SETCAT) 

COA3 AN ATTEMPT HAS BEEN MADE TO ALLOCATE DISC SPACE IN THE SYSTEM PORTION OF 
THE DISC. THIS IS A FATAL FILE MANAGER ERROR AND SHOULD BE REPORTED TO THE 
SYSTEM ADMINISTRATOR IMMEDIATELY. (SETCAT) 

COA4 AN ATTEMPT HAS BEEN MADE TO DE-ALLOCATE DISC SPACE IN THE SYSTEM PORTION 
OF THE DISC. THIS IS A FATAL FILE MANAGER ERROR AND SHOULD BE REPORTED TO 
THE SYSTEM ADMINISTRATOR IMMEDIATELY. (SETCAT) 


COBO FILE OR CATALOG DOES NOT REQUIRE CLEARING 

COB1 ATTEMPT TO CLEAR A FILE OR CATALOG WHICH IS OPENED ON A CHANNEL BY 
ANOTHER TASK 

COB2 ATTEMPT TO CLEAR A FILE WHICH IS A WORKFILE (TYPE = FF) 

COB3 COULD NOT CONSTRUCT FULL FILENAME FROM DLOC AND INDEX OF FILE ENTRY FOUND 
IN THE CHANNEL AREA ON DISC (FMCLEAR ERROR) 

COB4 ATTEMPT TO DELETE A FILE WHICH IS OPENED ON A CHANNEL BY ANOTHER TASK 

COB5 ATTEMPT TO CLEAR A FILE OR CATALOG WHICH IS OPENED ON A CHANNEL BY THIS 
TASK 

COB6 ATTEMPT TO DELETE A FILE WHICH IS OPENED ON A CHANNEL BY THIS TASK 

C100 NO CHANNEL AVAILABLE (GETFILE) 

C101 TEXT FILE IS ALREADY OPEN USING THE SAME FSB FSB(0) 1 (GETFILE) 

C102 TEXT FILE IS NOT OPEN (GETSTART) 

C103 TEXT FILE IS NOT OPEN (GETCLOSE) 

C104 TEXT FILE IS NOT OPEN (GETLINE) 

C105 FORMAT ERROR IN TEXT FILE (GETLINE) 

C108 TEXT FILE BUFFER IS NOT ALREADY IN MEMORY (GETCLEAR) 

C109 TEXT FILE iS NOT OPEN (GETMARK) 

C10A TEXT FILE IS NOT OPEN (GETPOS) 

C10B SAVED POSITION BELONGS TO DIFFERENT TEXT FILE (GETPOS) 

C10C LINE TOO LONG (GETLINE) 

C110 NO CHANNEL AVAILABLE (PUTFILE) 

C111 TEXT FILE IS ALREADY OPEN USING THE SAME FSB FSB(0) 1 (PUTFILE) 

C113 TEXT FILE IS NOT OPEN (PUTCLOSE) 

C114 TEXT FILE IS NOT OPEN (PUTLINE) 

C117 TEXT FILE IS NOT OPEN (PUTABORT) 

C120 NO CHANNEL AVAILABLE (READFILE) 

C121 TEXT FILE IS ALREADY OPEN USING THE SAME FSB FSB(0) 1 (READFILE) 

C122 TEXT FILE IS NOT OPEN (READPOS) 

C123 TEXT FILE IS NOT OPEN (READCLOS) 

C124 TEXT FILE IS NOT OPEN (READBLOK) 

C126 TEXT FILE IS NOT OPEN (READSECT) 

C129 BINARY FILE IS NOT OPEN (READMARK) 

C130 NO CHANNEL AVAILABLE (WRITFILE) 

C131 A FILE IS ALREADY OPEN USING THE SAME FSB FSB(0) 1 (WRITFILE) 

C133 BINARY FILE IS NOT OPEN (WRITCLOS) 

C134 BINARY FILE IS NOT OPEN (WRITBLOK) 
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FILE MANAGER C140 


NO CHANNEL AVAILABLE (MODIFILE) 


MANAGER C141 A FILE IS ALREADY OPEN USING THE SAME FSB FSB(0) 1 (MODIFILE) 
C201 THE BUFFER MANAGEMENT SYSTEM IS NOT ENABLED. 
(Continued) C202 ILLEGAL FILE IDENTIFIER PASSED TO THE BUFFER MANAGEMENT SYSTEM. 
C203 INACTIVE FILE IDENTIFIER PASSED TO THE BUFFER MANAGEMENT SYSTEM. 
C204 ATTEMPT TO SET THE SIZE OF A FILE TO A NEGATIVE NUMBER IN THE BUFFER MANAGE- 
MENT SYSTEM. 
C205 ATTEMPT TO ATTACH TOO MANY FILES TO THE BUFFER MANAGEMENT SYSTEM. 
C206 ATTEMPT TO SETDOWN THE BUFFER MANAGEMENT SYSTEM WHEN IT IS ALREADY OFF. 
C207 ATTEMPT TO SETDOWN THE BUFFER MANAGEMENT SYSTEM WHEN A FILE 1S 
ATTACHED TO IT. 
C208 ATTEMPT TO SETUP THE BUFFER MANAGEMENT SYSTEM WHEN IT HAS ALREADY BEEN 
SET UP. 
C209 ATTEMPT TO READ PAST THE END OF A FILE USING THE BUFFER MANAGEMENT 
SYSTEM. 
C20A ATTEMPT TO LOCK A SECTOR THAT IS NOT IN MEMORY 
C20B ATTEMPT TO BRING A BUFFER INTO MEMORY WHEN NO MORE ADDRESS SPACE 1S 
AVAILABLE 
C20C ATTEMPT TO CHANGE A WINDOW BUFFER THAT DOES NOT BEGIN ON A PAGE BOUNDARY 
C20D ILLEGAL USETYPE PASSED TO THE BUFFER MANAGEMENT SYSTEM 
C20E WINDOW PAGE TABLE OVERFLOW 
C20F NEGATIVE WORD COUNT PASSED TO THE BUFFER MANAGEMENT SYSTEM 
C300 THE BATCH FILE iS NOT OPEN FSB(0) 2 (BATCLEAR) 
C301 THE BATCH FILE IS NOT OPEN FSB(0) 2 (BATCLOSE) 
C302 THE FSB HAS A BAD INITIAL VALUE FSB(0) 1 (BATOPEN) 
C303 INVALID OPTION (BATRREQ) 
C304 THE STEP DOES NOT EXIST (BATRREQ) 
C305 INVALID STEP (BATWREQ) 
C306 BAD OPTION (BATWREQ) 
C309 THE BATCH FILE IS NOT OPEN (BATHEADR) 
C30A THE BATCH FILE IS NOT OPEN (BATWSDAT) 
C30B THE BATCH FILE IS NOT OPEN (BATRSDAT) 
C30C BAD BATCH FILE NAME (BATOPEN) 
FMCLEAR SYSNEWS.ERROR.FMCLEAR 
ERRORS 
8001 A SLASH (/) WAS EXPECTED IN THE COMMAND LINE 
8002 INVALID FMCLEAR OPTION SPECIFIED 
8003 UNKNOWN CHARACTER(S) AT END OF COMMAND LINE 
8004 FMCLEAR IS AN ILLEGAL COMMAND WITHIN AN EXECUTE FILE 
8005 FMCLEAR IS AN ILLEGAL COMMAND WHEN A HARDEFILE IS OPEN 
8006 FMCLEAR OF OPEN CHANNELS NOT ALLOWED WHILE OTHER USERS ARE LOGGED IN 
8007 FMCLEAR OF SYSCATLG NOT ALLOWED WHILE OTHER USERS ARE LOGGED IN 
8008 FMCLEAR OF SYSCATLG NOT ALLOWED FOR REMOTE NODES 
8009 BATCH TASK LOGGED IN. FMCLEAR NOT ALLOWED 


Messages Only in This Group: 


8800 
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FUTIL ERRORS 


FUTIL 
Runtime Errors 


FUTIL 
DISC ERRORS 


FUTIL PAPER 
TAPE AND CARD 
READER ERRORS 


Error Code Range — A000 - AOFF 


Contains the error messages printed for all the runtime errors. Subsidiary 
Ranges and SYM.EQU.FUTIL include. 


lO HANDLER ERRORS A000 - AQ1F (ERR-IO) 
DISC ERRORS A020 - A02F (ERR-DISC) 
PAPER TAPE AND CARDS A030 - A03F (ERR-CRPPT) 
MAGNETIC TAPE ERRORS A040 - AO6F (ERR-TAPE) 
ALL OTHER FUTIL ERRORS A070 - AO9F (ERR-MISC) 


SYSNEWS.ERROR.FUTIL.RUNNERS 


A000 


A001 
A002 
A003 
A004 
A005 
A006 
A007 
A008 
A009 
A00A 
A00B 
A00C 
A00D 
AOOE 
AOOF 
A010 
A011 
A012 
A013 
A014 
A015 
A016 
A017 
A018 


A019 


A020 
A021 
A022 
A023 


A024 


A031 


ATTEMPT TO DO IO BEFORE INITIALIZATION OF HANDLER INTERNAL FUTIL SOFTWARE 
ERROR (IOCNTRL) 

UNIDENTIFIABLE READ ERROR (IO) (IOCNTRL) 
UNIDENTIFIABLE WRITE ERROR (10) (IOCNTRL) 
READ PROCESS IO ERROR (TESTPROC) 

WRITE PROCESS IO ERROR (TESTPROC) 
UNIDENTIFIABLE 10 ERROR (CLOSER) 
UNIDENTIFIABLE IO ERROR (CLOSEW) 
UNIDENTIFIABLE lO ERROR (FILEINFO) 
UNIDENTIFIABLE lO ERROR (FIXFILE) 
UNIDENTIFIABLE IO ERROR (GETBUF) 
UNIDENTIFIABLE 10 ERROR (GETEMBUF) 
UNIDENTIFIABLE IO ERROR (NEXTFILE) 
UNIDENTIFIABLE IO ERROR (OPENR) 
UNIDENTIFIABLE 10 ERROR (OPENW) 
UNIDENTIFIABLE lO ERROR (PUTBUF) 

ILLEGAL 10 CALL (CLOSER) 

ILLEGAL lO CALL (CLOSEW) 

ILLEGAL IO CALL (FILEINFO) 

ILLEGAL IO CALL (FIXFILE) 

ILLEGAL 10 CALL (GETBUF) 

ILLEGAL IO CALL (GETEMBUF) 

ILLEGAL 10 CALL (OPENR) 

ILLEGAL lO CALL (OPENW) 

ILLEGAL IO CALL (PUTBUF) 

NO FREE FIR’S OR BIR’S AVAILABLE INTERNAL FUTIL SOFTWARE ERROR (GETREC, 
INITIO, GETEMBUF) 

BAD TYPE ARGUMENT 

INTERNAL FUTIL SOFTWARE ERROR (GETREC) 


CANNOT COPY A SINGLE VOLUME OR CATALOG 

CHECK PASS ERROR — CAN'T OPEN THE ORIGINAL DISC FILE 

CHECK PASS ERROR — THE DISC FILE BEING CHECKED HAS A NEW DATE 

CHECK PASS ERROR — THE CHKSUM OR FILE SIZE OF THE DISC FILE BEING CHECKED 
HAS BEEN CHANGED 

ATTEMPT TO SUPERSEDE A FILE WITH A CATALOG 


CARD READER ERROR 
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FUTIL MAGNETIC 
TAPE ERRORS 


GENERAL FUTIL 
ERRORS 
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CHECK PASS ERROR — DATA IN THE FILE BEING CHECKED DOEN’T MATCH THE DATA IN 
THE ORIGINAL FILE 
CHECK PASS INITIALIZATION ERROR CHECK PASS ABORTED 


- CHECK PASS ERROR — MAXIMUM ERROR COUNT EXCEEDED CHECK PASS ABORTED 


CHECK PASS ERROR 

CHECK PASS FATAL ERROR 

CHECK PASS — USER INTERRUPT CHECK PASS ABORTED 

CHECK PASS — FILE NAME CHANGE ON SAVE; FILE NOT CHECKED 

BAD SAVFIL HEAD RECORD 

EMPTY SAVFIL 

THE TAPE BLOCK READ IN IS LARGER THAN THE CALCULATED BLKSIZ 

THE SPECIFIED BLOCKED TAPE FILE CONTAINS NO DATA 

THE TAPE BLOCK READ IN WAS TERMINATED BY A PARTIAL RECORD 

ATTEMPT TO WRITE AN HDR1 LABEL AFTER AN EOV1 LABEL 

ATTEMPT TO WRITE AN HDR1 LABEL AFTER A RECORD THAT ISN’T A VOL1, EOF1 OR 
EOV1 LABEL | 
END-OF-TAPE ENCOUNTERED WHILE ATTEMPTING TO WRITE AN HDR1 LABEL. LABEL 
NOT WRITTEN 

END-OF-TAPE ENCOUNTERED WHILE ATTEMPTING TO WRITE A VOL1 LABEL. (EITHER A 
VOL1 LABEL !S BEING WRITTEN IN THE WRONG PLACE OR THE TAPE IS TOO SHORT TO 
CONTAIN EVEN A SINGLE 80 CHARACTER BLOCK) 

UNKNOWN LABEL TYPE IN A WRITE LABEL REQUEST (WRITELBL) 

A TAPE LABEL FIELD HAS AN ILLEGAL CHARACTER (THIS ERROR MEANS THERE IS BAD 
DATA IN THE LABELINF ARRAY) 

THERE IS NO VOL1 LABEL AS THE FIRST RECORD ON THIS REEL OF TAPE 

UNABLE TO ESTABLISH A USABLE POSITION ON THIS REEL OF TAPE. THIS USUALLY 
MEANS THAT A VOL1, HDR1, EOF1 OR EOV1 LABEL CAN'T BE FOUND. 

TAPE FILE DESIRED IS NOT CONTINUED ON THIS REEL OF TAPE 

TRIED TO WRITE THE USER LABELS (USR1...USR9) IN THE WRONG PLACE. THESE LABELS 
MUST IMMEDIATELY FOLLOW THE HDR LABELS FOR THE TAPE FILE. 

EMPTY FILE — FILE NOT COPIED TO TAPE 

BAD FILE CHKSUM — THIS USUALLY MEANS THAT THE DATA IN THE FILE HAS BEEN 
TRASHED 

FILE SIZE DISCREPANCY — THE SAVED VERSION OF THE FILE IS TOO BIG 

FILE SIZE DISCREPANCY — THE SAVED VERSION OF THE FILE IS TOO SMALL 
END-OF-TAPE ENCOUNTERED — ERROR 

AN ERROR OCCURRED WHILE TRYING TO SAVE THE COMMAND STATE IN A TEMP FILE. 


‘NO CHECK PASS CAN BE DONE; NO CONTINUATION REEL IS POSSIBLE. 


COULDN'T LOCATE THE DESIRED TAPE FILE 

ATTEMPT TO WRITE ON A TAPE REEL THAT HAS NO WRITE RING 
BAD IDREC — BAD FILE IMAGE HEADER RECORD (TAPE ERROR) 
TAPE DRIVE NOT READY OR NOT ON LINE 


UNIDENTIFIABLE ERROR DURING COMMAND INITIALIZATION (CMNDCTRL) 

ERROR IN 10 CLEANUP 

ERROR IN IO INITIALIZATION 

THE MAXIMUM NUMBER OF CONSECUTIVE ERRORS HAS BEEN EXCEEDED 

OVERLAY CONTROL READ ERROR 

ERROR OCCURED WHILE TRYING TO READ IN THE CONVERSION TABLE OVERLAY 
UNEXPECTED END-OF-FILE IN TEXT FILE (GETLINE) 

A TEXT LINE IN THE FILE WAS GREATER THAN 255 CHARACTERS. (GETLINE) 

TRIED TO “PUT” A LINE GREATER THAN 255 CHARACTERS INTO THE OUTPUT TEXT FILE 
(PUTLINE) 


FUTIL 
Scanner Errors 
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UTIL.FILSCAN ERROR RANGE A100 - A17F 
FUTIL ERROR RANGE A180 - AIFF 


SYSNEWS.ERROR.FILSCAN 


(File Scanner Errors/UTIL.FILESCAN) 


A100 
A101 

A102 
A103 
A104 
A105 
A106 
A107 
A108 
A109 
A10A 
A10B 
A10C 
A10D 
A10E 
A10F 
A110 


A111 


A112 


A113 
A114 


SCAN BUFFER OVERFLOW — CANNOT ACCEPT ANY MORE FILE NAMES. 

A FILE NAME, SLASH (/) OR END-OF-LINE (CR) WAS EXPECTED 

A COMMA (,), SLASH (/) OR END-OF-LINE (CR) WAS EXPECTED 

A SLASH (/) OR END-OF-LINE (CR) WAS EXPECTED 

WILD CARDS (! OR ?) ARE ONLY ALLOWED IN THE FILENAMELIST 

EMPTY CATALOG LEVEL 

THE EXPECTED SIZE OF A COMPLETE FILE NAME EXCEEDS 80 CHARACTERS 

A CATALOG LEVEL CONTAINED MORE THAN 20 CHARACTERS 

ILLEGAL CHARACTER IN A FILE NAME OR CATALOG LEVEL 

A VOLUME NAME OR NETWORK NODE NAME IS NOT ALLOWED IN THIS CATALOG 
EXCEPT OPTION THE EXCEPT OPTION IS ILLEGAL WHEN THE FILENAMELIST IS EMPTY 
A VOLUME NAME OR NODE NAME IS NOT ALLOWED IN THE FILENAMELIST 

SYSCATLG IS NOT ALLOWED IN THE FILENAMELIST 

AN EXCLAMATION POINT (!) IS ILLEGAL WITH A CATALOG LEVEL NAME SEGMENT 
SINCE/BEFORE OPTIONS A BAD DATE WAS SPECIFIED FOR A SINCE OR BEFORE OPTION 
TYPE OPTION A BAD HEX FILE TYPE WAS SPECIFIED 

EXCEPT/SUBCAT OPTIONS THE EXCEPT AND SUBCAT OPTIONS ARE ILLEGAL WITH AN 
EMPTY FILENAMELIST 

THIS CATALOG/FILENAME SPECIFICATION IS NOT ALLOWED IN THIS COMMAND (THE 
DEVICE SPECIFIED DOES NOT SUPPORT NAMED FILES) 

THE DESTINATION SPECIFICATION IS NOT ALLOWED IN THIS COMMAND (DELETE, PRINT, 
PRINTLP) 

TYPE OPTION GENERIC TYPE ERROR. (ERROR IN OPTION OR IN GENERIC TYPE FILES.) 
TYPE OPTION A RIGHT PARENTHESIS ‘)’ MUST TERMINATE THE TYPE SPECIFICATION 


SYSNEWS.ERROR.FUTIL.SCANNERS 


A180 
A181 
A182 
A183 
A184 
A185 
A186 


A190 
A191 


A192 


A193 
A194 
A195 
A196 
A197 
A198 
A199 
A19A 


A19B 


AN ILLEGAL VALUE IS SPECIFIED FOR AN EQUIVALENCED OPTION (OPTION = VALUE) 
UNKNOWN OPTION 

ILLEGAL SEPARATOR CHARACTER 

ILLEGAL COMMAND OR FUNCTION 

EMPTY ARGUMENT LIST NOT ALLOWED FOR THIS COMMAND 

THE VALUE OF AN EQUIVALENCED OPTION WAS OUT OF RANGE (OPTION = VALUE) 
UNABLE TO IDENTIFY A REQUESTED COMMAND PROCESS OVERLAY FUTIL SOFTWARE 
ERROR (OVLYSET) 

BAD UNIT OR UNIT NOT ATTACHED 

ILLEGAL “TO” DEVICE. THE FOLLOWING DEVICES ARE VALID: MAGNETIC TAPE, PAPER 
TAPE, LINE PRINTER OR COMDEV 

ILLEGAL “FROM” DEVICE. THE FOLLOWING DEVICES ARE VALID: MAGNETIC TAPE, 
PAPER TAPE OR CARD READER 

A RIGHT PARENTHESIS ()) CLOSES THE TAPE RECORD NUMBER LIST 

ILLEGAL MAG TAPE FILE NUMBER (N OF :MTN) 

A DIGIT WAS EXPECTED 

AN ILLEGAL CHARACTER WAS SPECIFIED IN AN INTEGER 

THE INTEGER HAS MORE THAN FIVE DIGITS 

DELETE OR MOVE OF SYSCATLG//NLEV IS NOT PERMITTED 

ONLY DISC FILES CAN BE DELETED 

THE CARD READER AND PAPER TAPE DEVICES ARE ONLY ALLOWED WITH THE CONVERT 
OR CONVERTB COMMANDS 

THE ADD COMMAND DOES NOT ALLOW A ‘TO’ DEVICE SPECIFICATION 
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A19C 


A19D 


A19E 


A19F 


AiA0 


A1A1 


A1A2 


A1A3 


AlA4 


A1A5 


A1A6 


A1A7 


A1A8 


A1A9 


A1AA 


A1AB 


A1AC 


AiAD 


A1AE 


A1AF 


A1B1 


A1B2 


A1B3 


THE ADD COMMAND CAN ONLY BE USED INSIDE OF FUTIL. ADD ONLY APPLIES TO FUTIL 
FORMAT OR SAVFIL FORMAT TAPES AND MUST FOLLOW A COPY COMMAND OR 
ANOTHER ADD COMMAND 

THE CHECK COMMAND MUST HAVE ONLY A VALID TAPE DEVICE SPECIFIED. 

NO OTHER FILE SPECIFICATIONS ARE ALLOWED WITH A TAPE RECORD LIST. (SOURCE, 
DESTINATION OR FILENAMELIST) 

THE ‘TO’ DEVICE FOR THE LIST COMMAND MUST BE BLANK, THE HARDEV, OR THE 
COMDEV 

THERE IS NO TAPE UNIT SPECIFIED FOR A SAVFIL OPTION REQUEST 

THERE IS NO TAPE UNIT SPECIFIED FOR A RSTFIL OPTION REQUEST 

DRWUPDAT OPTION 

THE “FROM” DEVICE MUST BE MAGNETIC TAPE OR DISC. THE “TO” DEVICE MUST BE 
DISC 

DRWUPDAT OPTION 

THIS OPTION IS ONLY VALID WITH THE ‘COPY’ COMMAND. 

DRWUPDAT OPTION 

AT LEAST ONE FILENAME MUST BE SPECIFIED IN THE FILENAMLIST. 

CONVERT OPTION 

ILLEGAL CONVERSION SET DESCRIPTOR. A CHARACTER SET DESCRIPTOR MUST BE 
EITHER ONE OR TWO LETTERS (A-Z) 

CONVERT OPTION 

A DASH MUST SEPARATE THE INPUT CONVERSION CHARACTER SET FROM THE OUTPUT 
CONVERSION CHARACTER SET 

CONVERT OPTION 

UNABLE TO ACCESS THE CHARACTER CONVERSION TABLES DIRECTORY FILE 
CONVERT OPTION 

A CONVERSION TABLE DOES NOT EXIST FOR THE REQUESTED CHARACTER SET(S) 
FORMAT OPTION 

ILLEGAL PUNCTUATION IN THE FORMAT OPTION. THE PROPER SYNTAX S: FORMAT = 
(OPTION. = VALUE) -OR- FORMAT = ( OPT1 = VAL1 , OPT2 = VAL2) 

FORMAT OPTION 

THE TAPE BLOCK SIZE (BLKSIZ) CALCULATED IS NOT AN EVEN NUMBER OF BYTES 
FORMAT OPTION 

THE CALCULATED BLOCK SIZE iS NOT AN EVEN MULTIPLE OF THE CALCULATED RECORD 
SIZE (BLKSIZ = RECSIZ RECCNT) 

FORMAT OPTION 

A SUB-OPTION HAS BEEN SPECIFIED TWICE (BLKSIZ, RECSIZ OR RECCNT) 

FORMAT OPTION 

ILLEGAL SUB-OPTION, MUST BE BLKSIZ, RECSIZ OR RECCNT. 

CONVERT OPTION 

THE El AND EA CHARACTER SETS ARE ONLY VALID FOR PAPER TAPE DEVICES 

LABEL OPTION 

ERROR IN TAPE LABEL ENTRY. ILLEGAL CHARACTER, TOO MANY CHARACTERS OR NO 
TERMINATOR CHARACTER A1B0 CONVERT OPTION OUTPUT CHARACTER SET MUST BE 
‘C’ FOR HARDEV OR COMDEV OUTPUT 

CONVERT OPTION 

INPUT CHARACTER SET MUST BE ‘C’ FOR CARDEV INPUT 

CONVERT OPTION 

A FILE MANAGER ERROR OCCURED WHILE TRYING TO READ IN ONE OF THE CHARACTER 
CONVERSION TABLES. 

CONVERT OPTION 

ONE OF THE CONVERSION CHARACTER SETS MUST BE CVASCII (C) 


SYSNEWS.ERROR.EDIT 


8001 
8002 
8003 
8004 
8005 


TAB STOP SPECIFIER IS TOO LARGE OR IS NEGATIVE 
A COMMA (,) WAS EXPECTED 

EXTRA CHARACTERS FOUND AT THE END OF THE LINE 
INVALID COLUMN NUMBER SPECIFICATION 

INVALID EDITOR COMMAND 


EDITOR 
ERRORS 
(Continued) 


FILERCVR 
ERRORS 


LOADER 
MAJOR 
ERRORS 


System Errors 


The information and drawings contained herein are the sole property of Computervision 
Corporation. Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
express written consent of Computervision. 


8006 
8007 
8008 
8009 
800A 
800B 
800C 
800D 
800E 
800F 


8010 
8011 


8012 
8013 
8014 
8015 


8001 


8001 
8002 
8005 


8006 


800D 
800E 


8010 
8011 
8012 
8013 


8015 
8016 
8017 
8018 


8019 
801A 
801B 


801C 
801D 
801E 
801F 


8021 
8022 
8023 
8024 


INVALID NUMBER OF DIGITS SPECIFIED (“"N’’ COMMAND) 

2ND COLUMN LESS THAN 1ST COLUMN IN COLUMN BOUNDS SPECIFICATION 

BAD CHARACTER(S) IN COLUMN BOUNDS SPECIFICATION 

ATTEMPT TO INITIALIZE A CASE THAT IS PRESENTLY SET (B OR U COMMAND) 

EDIT BUFFER IS FULL 

LINE NUMBER NOT FOUND IN EDIT BUFFER 

INVALID FILENAME SPECIFICATION 

MISSING LINE NUMBER SPECIFICATION 

A DISC LOCATION REQUESTED WITHIN FILE EXCEEDS THE FILE LENGTH 

A CHARACTER WAS REQUESTED FROM THE LAST SECTOR IN THE FILE, BUT THE POSI- 
TION WITHIN THE SECTOR EXCEEDS THE COUNT OF VALID CHARACTERS. 

A ZERO LINE NUMBER WAS ENCOUNTERED FOR A FILE PAGE-IN REQUEST (GETTAB) 
AN ATTEMPT WAS MADE TO OPEN A FILE WHICH IS NOT A TEXT FILE (TYPE=03) 
(LOADTEXT) 

LINE NUMBER OUT OF BOUNDS 

NO CHANNEL AVAILABLE 

EXPANDED COMMAND STRING OVERFLOW 

ERROR ON ATTEMPT TO OPEN EDITOR TEMPORARY FILE 


FILE SPECIFIED IS NOT AN UNRECOVERED HARDFILE 


ATTEMPT TO READ THE SIZE OF A SYMBOL THAT IS NOT A GLOBAL 
ATTEMPT TO EXECUTE WHEN A BLOCK HAS OVERFLOWED 


ATTEMPT TO STORE A WORD AT AN ADDRESS LESS THAN THE CORORG START AD- 
DRESS, OR (IF A SECOND PARAMETER IS GIVEN WITH THE CORORG STMT) AT AN AD- 
DRESS GREATER THAN THE CORORG START ADDRESS PLUS THE BUFFER LENGTH IN- 
DICATED BY THE SECOND CORORG PARAMETER. THIS ERROR OCCURS BECAUSE AN AT- 
TEMPT IS MADE TO LOAD A PROGRAM OR INITIALIZE A GLOBAL AT A BAD ADDRESS. 
ATTEMPT TO READ A WORD FROM AN ILLEGAL ADDRESS THIS ALMOST ALWAYS IN- 
DICATES THAT THE CURRENT BLOCK (OR, MORE RARELY, AN EARLIER BLOCK) HAS 
OVERFLOWED. 

FORMAT ERROR IN OBJECT FILE DATA BLOCK HAS A BAD COUNT 

SET LOCATION BLOCK IN OBJECT FILE TRYING TO SET LOCATION AT A SYMBOL THAT IS 
NOT YET DEFINED. THIS ERROR OCCURS WHEN TPL SOURCE CODE TRIES TO DATA IN- 
ITIALIZE (VECTOR VALUES) A GLOBAL OF INDEFINITE LENGTH (DIMENSIONED WITH A *) 
AND THE LOCATION OF THAT GLOBAL IS NOT YET DEFINED 

INTERNAL ERROR IN OBJECT FILE 

BAD CHARACTER WHERE A SLASH (/) IS EXPECTED IN THE LOADER (OS) COMMAND LINE 
CORORG COMMAND SPECIFIES A BLOCK OUTSIDE THE RANGE 0000-8000. 

NESTED INSERTS IT IS ILLEGAL TO USE THE INSERT COMMAND WHILE INSIDE AN INSERT 
FILE 

BAD CHARACTER WHERE AN EQUAL SIGN (=) IS EXPECTED IN A FILL COMMAND 
SYMBOL IN A GLOBAL COMMAND IS ALREADY DEFINED 

BAD CHARACTER WHERE A PARENTHESIS [) OR (] IS EXPECTED IN A GLOBAL COMMAND 
BAD CHARACTER WHERE A COMMA (,) IS EXPECTED IN ANY OF THE FOLLOWING COM- 
MANDS: GLOBAL, SYM, TV, UNDEF 

ILLEGAL FUNCTION 

ATTEMPT TO EXECUTE WHEN A SYMBOL IS NOT DEFINED 

BAD CHARACTER WHERE A RIGHT SQUARE BRACKET (]) IS EXPECTED IN A FUNCTION 
EXPRESSION 

SYMBOL SPECIFIED IN A SET COMMAND HAS AN UNDEFINED LOCATION 

BAD CHARACTER WHERE A RIGHT PARENTHESIS [)] IS EXPECTED IN A SET COMMAND 
BAD CHARACTER WHERE AN EQUAL SIGN (=) IS EXPECTED IN A SET COMMAND 
ATTEMPT TO DEFINE A SYMBOL THAT ALREADY HAS A DEFINITION USING AN EQU 
COMMAND 

BAD LOADER COMMAND: KEYWORD NOT RECOGNIZED 

ILLEGAL OPTION ON LOADER (OS) COMMAND LINE 

OVERLAY FILE WILL BE BIGGER THAN ‘FFFF’ SECTORS 

INTERNAL LOADER ERROR ATTEMPT TO DEFINE A SYMBOL THAT IS ALREADY DEFINED 
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8028 
8029 
802A 


802B 


802C 
802D 
802E 
802F 
8030 
8031 

8032 
8033 
8034 
8035 


8036 
8037 


803B 
803C 
803E 


803F 


8040 


SYMBOL TABLE OVERFLOW: TOO MANY SYMBOLS HAVE BEEN CREATED 

XRWAD TABLE OVERFLOW 

TOO MANY TOTAL ENTRY POINTS, CALLED SUBROUTINES AND GLOBALS REFERENCED 
FROM AN OBJECT FILE 

ATTEMPT TO EXECUTE WITH THE LOW END OF CORORG BUFFER BELOW 2000 HEX, OR 
THE HIGH END ABOVE 4000 HEX. THE LOW END OF THE CORORG BUFFER IS THE 
ADDRESS FOLLOWING THE ‘CORORG’ KEYWORD IN THE MAKE FILE. THE HIGH END OF 
CORORG BUFFER IS EITHER: 1) THE LOW ADDRESS PLUS THE SPECIFIED SIZE OF CORORG 
BUFFER, IF A SIZE IS SPECIFIED BY THE USER; OR 2) 8000 HEX. 

START ADDRESS SPECIFIED IN AN EXECUTE COMMAND HAS AN ADDRESS OUTSIDE THE 
OVERLAY THAT WAS CREATED 

THE OVERLAY FILE EXISTS IN THE NEWCAT CATALOG BUT CANNOT BE MODIFIED 
BECAUSE IT IS IN USE 

PART OF THE BLOCK TO BE WRITTEN TO THE DISC FALLS OUTSIDE THE OVERLAY AS 
DEFINED IN THE CORORG COMMAND 

LEFT PARENTHESIS [(] IN AN EXPRESSION DOES NOT HAVE A MATCHING RIGHT PAREN- 
THESIS [)] 

SYMBOL REFERENCED IN AN EXPRESSION IS NOT DEFINED 

TWO OPERATORS OR TWO OPERANDS IN A ROW IN AN EXPRESSION 

NULL STRINGS ARE ILLEGAL 

COMMAND DOES NOT HAVE ENOUGH NUMERICAL ARGUMENTS 

COMMAND HAS TOO MANY NUMERICAL ARGUMENTS 

FIRST OPERAND OF A BOOLEAN EXPRESSION IS A STRING LONGER THAN TWO 
CHARACTERS 

ILLEGAL BOOLEAN OPERATOR 

SECOND OPERAND OF A BOOLEAN EXPRESSION IS A STRING LONGER THAN TWO 
CHARACTERS 

ENTRY POINT NOT FOUND IN LOAD LIBRARY 

INTERNAL LOADER ERROR 

ATTEMPT TO DATA INITIALIZE A GLOBAL USING A SET COMMAND EXCEEDS THE LIMITS 
OF THE GLOBAL 

AN ATTEMPT BEING MADE TO RESOLVE AN ESI MODE RELOCATION USING PC RELATIVE 
ADDRESSING, BUT THE REFERENCE AND THE LOADER-GENERATED PZE ARE NOT WITHIN 
THE NOVA ADDRESSING RANGE (- 128 TO +27 WORDS) 

W DATA SECTION OF OBJECT FILE BEING LOADED HAS BECOME LARGER THAN 100 HEX. 
THE LOADER WILL EXPAND THE LOW DATA SECTION OF AN OBJECT FILE IN ORDER TO 
CREATE LINKAGES TO OTHER SUBROUTINES AND TO GLOBALS. THE RESULTING SIZE 
AFTER EXPANSION CANNOT BE LARGER THAN 100 HEX. THIS ERROR CONDITION CAN 
ALMOST ALWAYS BE SATISFIED BY MOVING LOCAL INTEGER ARRAYS INTO A COMMON 
AREA (FORTRAN) OR CONVERTING THEM TO GLOBALS (TPL) IN THE OBJECT FILE IN 
QUESTION, THEN RECOMPILING THAT OBJECT FILE AND RELOADING. 

OVERLAY FILE NAME IS NOT SPECIFIED 

OVERLAY FILE IS LARGER THAN ‘FFFF’ SECTORS LONG 

AN OBJECT FILE CREATED FROM A TPL SOURCE FILE HAS REFERRED TO A GLOBAL OF 
INDEFINITE LENGTH (USING A * DECLARATION), BUT THE GLOBAL IS UNDEFINED WHEN 
THE OBJECT FILE IS LOADED 

ATTEMPT TO SAVE A SYMBOL TABLE THAT CONTAINS AN UNDEFINED SYMBOL 

FILE NAME IS NOT SPECIFIED FOR A LOADSYM OR SAVESYM COMMAND 

FILE SPECIFIED FOR A LOADSYM COMMAND IS NOT A LOADER DATA FILE 

FILE SPECIFIED FOR A LOADSYM COMMAND IS NOT A SAVED SYMBOL TABLE 
SYMBOL TABLE IN THE FILE SPECIFIED FOR A LOADSYM COMMAND IS IN AN OLD FOR- 
MAT AND CANNOT BE USED BY THE CURRENT VERSION OF THE LOADER. 

FILE SPECIFIED FOR A LOADSYM COMMAND HAS A BAD CHECKSUM 

THE ARGUMENTS TO A BLOCK COMMAND ARE IN THE WRONG ORDER. THE STARTING 
ADDRESS OF THE BLOCK IS LARGER THAN THE ENDING ADDRESS OF THE BLOCK. 

NO MORE LINES IN INPUT FILE. THIS CAN HAPPEN WHEN AN INSERT FILE IS NOT 
TERMINATED BY AN END COMMAND, OR A MAKE FILE IS NOT TERMINATED BY AN 
CWRITE, END, EXECUTE OR WRITE COMMAND. 

BLOCK COMMAND SPECIFIES A BLOCK THAT IS OUTSIDE OF ADDRESSABLE MEMORY. 
ATTEMPT TO ALLOCATE A NEGATIVE NUMBER OF WORDS THIS CAN HAPPEN WHEN A 
GLOBAL COMMAND SPECIFIES A BAD GLOBAL SIZE. 

FILL STATEMENT IS DATA INITIALIZING A SYMBOL THAT IS NOT A GLOBAL 
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80D4 


80D5 


SET STATEMENT IS DATA INITIALIZING A SYMBOL THAT !S NOT A GLOBAL 

FUNCTION VALUE IS NOT AN INTEGER 

OBJECT FILE WAS COMPILED BY AN OLD VERSION OF THE COMPILER WHICH IS INCON- 
SISTENT WITH THE CURRENT LOADER. 


ATTEMPT TO CHANGE THE MODE OF A SYMBOL 

ATTEMPT TO SET THE ESI OF A SYMBOL TO A VALUE GREATER THAN ‘FF’ 

AN ENTRY POINT OF THE OBJECT FILE BEING LOADED ALREADY HAS ANOTHER 
DEFINITION | 

FORMAT ERROR IN OBJECT FILE THE LAST WORD OF THE OBJECT FILE BEING LOADED IS 
NOT THE END-OF-FILE FLAG (‘FFFF’) 

INTERNAL CHECKSUM ERROR IN OBJECT FILE 

EXTERNAL CHECKSUM ERROR IN OBJECT FILE 

THE OBJECT FILE BEING LOADED IS REFERRING TO A GLOBAL THAT IS SMALLER THAN 
THE DECLARATION IN THE SOURCE FILE 

BAD CHARACTER WHERE A SLASH IS EXPECTED IN A LOAD OR LOADLIB COMMAND 
LOAD LIBRARY FILE 1S NOT A LOADER DATA FILE 

LOAD LIBRARY FILE 1S A LOADER DATA FILE BUT DOES NOT CONTAIN A LOAD LIBRARY 
LOAD LIBRARY FILE IS IN AN OLD FORMAT AND CANNOT BE USED BY THE CURRENT 
VERSION OF THE LOADER 

FILE TO BE LOADED IS NOT A TYPE 2 (OBJECT) FILE 

LOADER STATEMENT HAS EXTRA CHARACTERS AT THE END OF THE LINE 


AN EXTERNAL REFERENCE FILL IN CHAIN STARTS AT LOCATION ZERO. THIS OCCURS 
WHEN CODE IS LOADED INTO A BLOCK STARTING AT 0000, AND THAT LOCATION MUST 
BE FILLED IN WITH AN EXTERNAL REFERENCE. 

AN OBJECT FILE IS REFERRING TO A GLOBAL THAT WAS NOT DEFINED AS A GLOBAL. A 
GLOBAL MUST BE DEFINED USING A LOADER GLOBAL COMMAND OR ALLOCATED WHEN 
AN OBJECT FILE IS LOADED 

A SUBROUTINE CALL OR DEFINITION HAS THE WRONG NUMBER OF ARGUMENTS THIS 
ERROR CAN OCCUR IN THREE WAYS: 

(1) THE SUBROUTINE WAS PREVIOUSLY DEFINED AND A CALL USES A DIFFERENT 
NUMBER OF ARGUMENTS 

(2) THE SUBROUTINE WAS PREVIOUSLY CALLED AND A CALL USES A DIFFERENT 
NUMBER OF ARGUMENTS 

(3) THE SUBROUTINE WAS PREVIOUSLY CALLED AND A DEFINITION SPECIFIES A DIF- 
FERENT NUMBER OF ARGUMENTS 


SYSNEWS.ERROR.SORTCAT 


8101 
8102 
8103 
8104 
8105 


8106 


SORT ABORTED 

CANNOT SORT SYSCATLG WITH OTHER TASKS LOGGED IN 

NO SORT PERFORMED 

FILE iS NOT A CATALOG 

CANNOT SORT CATALOGS WITH DIRECTORY ENABLED YOU HAVE TWO CHOICES: 

1) SPECIFY CATALOG EXPLICITLY BY PREFIXING COMPLETE CATALOG WITH DIRECTORY- 
OVERWRITE CHARACTER, =. 

2) DISABLE THE DIRECTORY AND PERFORM THE SORT. 

CANNOT SORT SYSCATLG WITH BATCH TASK LOGGED IN 


SYSNEWS.ERROR.SRCHBCD 


8001 
8002 
8003 
8004 


A SLASH (/) WAS EXPECTED IN THE COMMAND LINE 
ERROR IN “SINCE” DATE FORMAT 

ERROR IN ‘BEFORE’ DATE FORMAT 

INVALID OPTION IN COMMAND LINE 
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SRCHBCD 8005 INVALID CHARACTER(S) AT END OF COMMAND LINE 
8006 A COMMA (,) WAS EXPECTED IN THE COMMAND LINE 

ERRORS 8007 INVALID SRCHBCD COMMAND 

(Continued) 8009 SPECIAL CHARACTER DELIMITERS NOT ALLOWED WITH “S” OR “G” COMMAND 
800A SEARCH STRING HAS AN IDENTIFIER LONGER THAN 8 CHARACTERS (“G” OR “S” 

SEARCH) 

800B NO CHANNEL AVAILABLE 

SUBMIT Used by PERROR (SYSOV.PERROR) to output appropriate error message 

ERRORS to user COMDEV. See PERROR for details of table format. 
8001 BAD OPTION | 
8002 NO SLASH (/) WHERE ONE IS EXPECTED 
8003 NO EQUAL SIGN (=) WHERE ONE IS EXPECTED 
8004 NO JOB NAME SPECIFIED 
8005 BAD TASKUNITNAME 
8006 NO COMMA (,) FOUND WHERE ONE IS EXPECTED 
8007 BAD DEVICE NAME 
8008 MISSING QUOTE (“ OR ‘) 
8009 MISING ENDING QUOTE (” OR “) 
800A VOLUME NAME DOES NOT BEGIN WITH A STAR (*) 
800B ATTEMPT TO DELETE A STEP THAT DOES NOT EXIST 

CVTECO 8001 NO CHARACTERS ARE PRESENT WHEN A COMMAND WANTS A STRING ARGUMENT 
8002 ILLEGAL COMMAND 

ERRORS 8003 TWO OPERATORS IN A ROW IN AN EXPRESSION 
8004 OR / USED AS A PREFIX OPERATOR 
8005 E COMMAND NOT FOLLOWED BY A LETTER 
8006 E COMMAND FOLLOWED BY AN ILLEGAL LETTER 
8007 FILENAME MISSING FROM E COMMAND 
8008 SEARCH STRING IS TOO LONG (IN AN F, R OR S COMMAND) 
8009 SEARCH STRING NOT FOUND (IN AN F, R OR S COMMAND) 
800A CVTECO INVOKED BY A BAD OS COMMAND LINE 
800B “” WITHOUT MATCHING “” 
800C ILLEGAL Q-REGISTER NAME 
800D NO NUMERICAL ARGUMENT TO A P COMMAND 
800E “"” COMMAND NOT FOLLOWED BY A LETTER 
8012 REPLACEMENT STRING IN R COMMAND IS TOO LONG 
8013 TEXT WILL NOT FIT INTO A T-REGISTER 
8014 CANNOT EXTRACT TEXT FROM AN EMPTY T-REGISTER 
8015 MACRO CONTAINS UNMATCHED “” OR “[” 
8016 “” WITHOUT MATCHING ““” 
8017 E COMMAND NOT FOLLOWED BY A LETTER 
8018 E COMMAND FOLLOWED BY AN ILLEGAL LETTER 
8019 ILLEGAL ARGUMENT TO S COMMAND 
801A “” WITHOUT MATCHING “[” 
801B “)"” WITHOUT MATCHING “[” 
801C ILLEGAL “[” WITH ONE NUMERIC ARGUMENT 
801D ILLEGAL “[” WITH TWO NUMERIC ARGUMENTS 
S01E WRONG NUMBER OF NUMERIC ARGUMENTS FOR A “[”” COMMAND 
801F ARGUMENT TO THE “V’ COMMAND IS NOT POSITIVE 
8020 BAD OPTION ON THE CVTECO COMMAND LINE 
8021 NO “=” FOLLOWING THE /MACRO OPTION 
8801 ANOTHER FILE ALREADY OPEN FOR OUTPUT 
8802 NO FILE OPEN FOR OUTPUT IN EP & EX COMMANDS 
8803 TEXT LINE IS LONGER THAN 255 CHARACTERS AND CANNOT BE WRITTEN TO A TEXT FILE 
8804 NO FILE OPEN FOR OUTPUT IN EF & EX COMMANDS 
8901 INSERT OVERFLOWS THE TEXT BUFFER 
3902 MOVE POINTER OFF THE END OF THE BUFFER 
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DELETE ARGUMENTS ARE IN THE WRONG ORDER 
DELETE ARGUMENTS ARE OFF THE END OF THE BUFFER 
DISC BUFFER OVERFLOW 

SCAN ARGUMENTS ARE IN THE WRONG ORDER 

SCAN ARGUMENTS ARE OFF THE END OF THE BUFFER 
REQUEST FOR CHARACTER OFF THE END OF THE BUFFER 
MOVE MARK OFF THE END OF THE BUFFER 


SYSNEWS.ERROR.UTIL 


9801 
9802 


9803 


9804 


9805 


9808 


9809 
980A 
980C 
980D 
980E 
980F 


9810 


HEAP SIZE ALLOCATED IS TOO SMALL.(GTBLK) MUST BE AT LEAST 6 WORDS. 
ILLEGAL SIZE IN REQUEST FOR BLOCK FROM GTBLK. EITHER REQUEST FOR LESS THAN 0 
OR NO FREE BLOCK BIG ENOUGH. 

HEAP NOT INITIALIZED (FRBLK) SINCE HEAP NOT INITIALIZED, NO BLOCKS HAVE BEEN 
ALLOCATED. FRBLK ARGUMENTS MUST BE SPURIOUS 

ILLEGAL BLOCK AS ARGUMENT TO FRBLK EITHER THE SIZE OR THE LOCATION OF THE 
BLOCK IS NOT LEGAL. 

PART OF BLOCK IS ALREADY FREE (FRBLK) PART OF THE BLOCK IS NOT ALLOCATED AND 
HENCE CAN'T BE FREED 

DEVICE NOT RECOGNIZED OR NOT APPROPRIATE FOR OPERATION EITHER AN INPUT 
DEVICE IS BEING USED FOR OUTPUT, AN OUTPUT DEVICE IS BEING USED FOR INPUT, OR 
THE DEVICE IS NOT RECOGNIZED BY LINEIO. 

FILE IS NOT IN APPROPRIATE STATE. EITHER STATUS IS NOT “OPENED FOR WRITE” IN 
PTLN OR NOT “OPENED FOR READ” IN GTLN 

ILLEGAL LINE LENGTH GIVEN TO PTLN LINE LENGTH IS EITHER LESS THAN 0 OR GREATER 
THAN 255. 

NO RESET DONE ON STACKIN PACKAGE 

STACKIN’S INTERNAL STACK HAS OVERFLOWED TOO MANY PUSH-BACKS 

TOO MANY LISTS IN COMMAND LINE (CMNDLN) MAXIMUM SPECIFIED IN 
SYM.DEFS.UTIL.CMNDLN 

TOO MANY FIELDS IN COMMAND LINE (CMNDLN) MAXIMUM SPECIFIED IN SYM.DEFS. 
UTIL.CMNDLN 

COMMAND LINE TOO LONG (CMNDLN) MAXIMUM SPECIFIED IN SYM.DEFS. 
UTIL.CMNDLN 
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Access Time 


Accumulator (AC) 


Accuracy 
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Acoustic Coupler 
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ACU 
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GLOSSARY 


Values of X, Y, or Z coordinates with respect to the origin of the coor- 
dinate system. Contrast with ‘Incremental Coordinate.”’ 


The layer on which text will be placed. If the ALAY5 modifier is used when 
a text node is inserted, text placed on the text node will be placed on layer 
5. 


The interval between the instant at which data is required from or for a 
storage device, and the instant at which the data actually begins moving to 
or from the device. 


A CPU register used to hold operands. 


The number of significant digits of information in data, i.e., the number of 
digits after the decimal point. CADDS 4 is accurate to seven digits. 


Use in DLE sequences in Binary Synchronous Communications, these 
replies indicate that the previous transmission block was accepted by the 
receiver, and that it is ready to accept the next transmission block. Use of 
ACKO and ACK1 alternately provides sequential checking control for a 
series of replies. ACKO is also an affirmative (RxRDY) reply to a station 
selection (multipoint), or to an initialization sequence (line bid) in point-to- 
point operations. 


A device that permits computer data to be transmitted over the public 
telephone network. 


Advanced Communications Service; a planned data transmission network. 


Automatic Calling Unit. A dialing device that permits a business machine 
to dial calls automatically over the communications network. 


Advanced Data Communications Control Procedure. This is the ANSI 
version of bit-oriented DLC. 


A number that designates a location where information is stored. 


The number of locations that a single address can specify. 


Alphanumeric 


Alphanumeric 
Display Device 


ALU 


Amplitude 
Modulation (AM) 


Annotation 


ANSI 


Aperture 
Correspondence 
Table 


APL 


Application 
Program 


APT 


APT Canonical 
Output 


Arc @ Width 


ARQ 
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The subset of characters that includes the 26 alphabetic characters and the 
10 numeric characters. 


A device capable of displaying a fixed set of letters, digits, and 
special characters, in one or more fonts. It allows the user to enter com- 
mands and to receive messages from the system. The device consists of a 
typewriter style keyboard and a display (CRT) on which text is viewed. See 
‘“‘Command Device.” 


Arithmetic/Logic Unit. 


A method of transmission whereby the amplitude of the carrier 
frequency is modified in accordance with the amplitude of the intelligence 
signal. 


The process of inserting nodal text on a schematic diagram or printed 
circuit drawing. 


American National Standards Institute. 


A text file which provides interface information to be used by a photo- 
plotter. The main body of the table is made up of lines that describe the 
apertures on the wheel. 


Automatic Program Load: A built-in automatic sequence that allows the 
user to start the system by pressing a switch. Also the name of A Program- 
ming Language. 


A program that performs a function specific to a particular end-user’s need 
or to a class of needs. An application program can be any program that is 
not part of the basic operating system. 


Automatically Programmed Tools: a program language used to prepare 
numerical control (NC) tapes. Associative APT output geometry will be in 
canonical form and the toolpaths will be related to the geometry via tags. 


APT Canonical is a specific mathematical formulation of 3D geometry to 
be output from the CADDS system. This data is used as input to a user’s 
APT system which executes on another computer. 


A term used to describe arcs and circles which have a photoplotter aper- 
ture width associated with them. 


Automatic Request for Repeat (of transmission). 
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ASCII 


Assembler 


Associative APT 
Output 


Asynchronous 
Asynchronous 
Transmission 
Attention Point 


Autoroute 


B-Spline 


B-Spline Surface 


Back Annotation 


Backplane 


Bandwidth 


American Standard Code for Information Interchange. One of the 
character codes (7-bit plus parity code) used in computer applications. 


A computer program that converts symbolic instructions into equivalent 
machine instructions. 


A feature that outputs CADDS geometry and toolpaths in APT format. 
The geometry is in canonical form and the toolpaths are related to the 
geometry via tags. Associative APT output can be used by CADDS users 
as input to their APT system on other computers. 


Pertaining to related events where all changes do not occur at the same 
time. 


Transmission in which time intervals between transmitted characters may 
be of unequal length. Transmission is controlled by start and stop bits. 


A small box (()) placed on the display of an entity to indicate selection of 
that entity. The exact location varies according to the entity type. 


A CV software package which automatically adds interconnections to a PC 
board by merging a signal list with the PC board drawing. 


A mathematical method for representing smooth curves, especially suited 
for machining and graphic display. The mathematical definition of a curve 
which passes through three-dimensional space, e.g., locus of points which 
define a corkscrew. The curve is mathematically continuous for both the 
1st and 2nd derivatives, and provides the basis for much mechanical 
design and subsequent machining operations. 


The mathematical description of a three-dimensional surface which passes 
through a set of B-splines. Current applications include turbine blade 
design of jet engines and sculptured surface for automotive design. 


A process where information is extracted from a completed printed circuit 
board and inserted onto the logic elements of the schematic which 
describes the PC board. The information extracted is usually pin numbers 
and component reference numbers for each component on the PC board. 


The PC board in the rear of the CGP that interfaces between the other 
boards and the |/O cables. 


The range of frequencies assigned to a channel or system. 
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Transmission of a signal at its original frequencies, without modulation. 


The essential components needed by an I/O unit to communicate with the 
CPU. Basic interface logic includes: data register(s), busy, done and 
interrupt flip-flops, device select and device identification logic, as well as 
a priority circuit. 


A group of jobs run on a computer at a single time without human 
intervention. 


A measure of signaling speed equal to the number of discrete conditions or 
signal events per second. In asynchronous transmission, baud is the unit 
of signaling speed corresponding to 1 unit interval per second, and is the 
same as bits per second, only if each signal event represents one bit 
exactly. 


A code for the transmission of teleprinter data in which 5 bits represent 1 
character. It is named for Emile Baudot, a pioneer in printing telegraphy. 


The number system with a base of two used to represent the internal logic 
of all digital numbers. 


A code that uses two distinct characters, usually the numbers 0 and 1. 


An IBM defined character controlled communications protocol. 


A binary digit — the smallest unit of information in a binary system of 
notation. It corresponds to a O or 1 and one digit position in a physical 
memory. 


A data link control characterized by 1 standard frame format, zero inser- 
tion and deletion, CRC-CCITT preset to “‘1’’s, Flag, Abort, and IDLE 
unique control bit patterns, and synchronous transmission in HDX or FDX 
modes. 


The number of bits transferred; usually expressed in bits per second. A 
group of characters transmitted as a unit. Same as Frame. 


Part of a transmission verification algorithm. 
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BOM Bill of Material: A parts list for a printed circuit board or equipment draw- 
ing. Part type, quantity, and other properties are listed from which items 
may be ordered for the manufacturing process. 

Boot-Up The term used to identify the system start-up process. 


Bootstrap Loader 


A technique or routine whose first instructions are sufficient to load the 
remainder of itself and to start a complex system of programs. 


BOT Beginning of Tape: A reflective marker applied to the back side of a 
magnetic tape which identifies the beginning of the tape’s recordable 
surface. 

BPI Bits Per Inch. 

BPS Bits Per Second transmitted or received; serial data rate. 

Break A long (GT 200 msec) space on an asynchronous communications line that 
is intended to alert the receiving CPU. Minimum duration is 1 character 
time. 

Broadband See Wideband. 

Buffer A storage area used to hold (temporarily) information being transferred 
between two devices or between a device and memory. A buffer is often a 
special register or a designated area in memory. Also used to compensate 
for differences in the rates of data flow between two devices. 

Bug A flaw in the design or implementation of a program which may cause 
erroneous results. 

Bullet A symbol which indicates electrical and logical connectivity of nets. A 
bullet does not indicate a physical connection at that point. A bullet in 
CADDS is represented by a nodal subfigure or by a connect node not 
associated with a nodal subfigure, |.e., a stand-alone connect node. 

Bus A circuit used as a power supply or data exchange line between two or 
more devices. 

Byte A binary element string, usually operated upon as a unit, and typically 
shorter than a computer word (e.g., eight bits). 

CAD Computer Aided Design. 
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CADDS 
CAM 
Carrier 


Carrier System 


Catalog 


CCITT 


CD3PRTS 

CE 

Cell 

Central Office 
Central Process- 
ing Unit (CPU) 
CGOS 

CGP 


Channel 


Channel Capacity 


Character 
Character String 


Circuit 


Computer Aided Design and Drafting System. 

Computer Aided Manufacturing. 

A continuous frequency capable of being modulated with a signal. 

A means of obtaining a number of channels over a single path, modulating 
each channel upon a different carrier signal, and then demodulating at the 


receiving point to restore the intelligent signals to their original forms. 


An index which may be used to locate a particular file or group of files. 
More generally, a group of files belonging to one family of files. 


Comite Consultatif Internationale de Telegraphie et Telephonie. An inter- 
national consultative committee which sets international communications 
standards. 

The catalog name for all CADDS 3 parts. 

Customer Engineer. 


Physical location of a single data bit in memory. 


Location where communications common carriers terminate customer 
lines and house the equipment that interconnects these lines. 


A unit of the processor that includes the circuits controlling the interpreta- 
tion and execution of instructions. 


Computervision Graphics Operating System. 

Computervision Graphics Processor. 

The part of a communications system that connects a communications 
source with its destination. A path for electrical transmission between two 
or more points. Also called a circuit, facility, line link, or path. 

The maximum baud rate which can be handled by the channel. 

An alphabetic, numeric, or special graphic symbol. 


A series of characters arranged in a meaningful sequence. 


The complete electrical path providing 1- or 2-way communications be- 
tween two points. See also Channel. 
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Circuit Switching 


~ Clear 
CLINK 


Clock 


CMORT 

Code 

Coefficient 
Command 
Command Device 
Command Line 


Common Carrier 


Communication 
Control 
Character 


Compiler 


A method of communications, where an electrical connection between 
calling and called stations is established on demand for exclusive use of the 
circuit until the connection is released. See also Packet Switching and 
Message Switching. 


To erase the contents of a storage location by replacing the contents, 
normally with zeros or spaces. 


CADDS graphics coreload initiation routine; the process of transferring 
control from one coreload to another. 


A device that generates regular periodic signals for synchronization. 


CV Multiprogramming Reliability Test: A system test to exercise and verify 
the reliability of CV system installations. 


A system of symbols and rules used for representing information. Code 
usually refers to instructions executed by a computer. 


A number by which a variable or mathematical expression is to be 
multiplied. 


A word, mnemonic, or character which, by virtue of its syntax in a line of 
input, Causes a computer system to perform a predefined operation. 


A device that provides communication between an operator and a system. 
See Alphanumeric Display, LIS, and Telewriter. 


Entry which follows certain rules of syntax to cause a particular event to 
occur. 


In data communications, a public utility company which is recognized by 
an appropriate regulatory agency as having a vested interest and respon- 
sibility in furnishing communications services to the general public (e.g., 
Western Union and the Bell System). See also Specialized Common 
Carrier and Value Added Service. 


A functional character that controls or facilitates transmission over data 


networks. See also Control Character. 


A computer program that translates instructions written in a higher order 
symbolic language (such as FORTRAN) into a series of machine instruc- 
tions. 
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Component A symbol which has a physical meaning. Examples include switch, 
resistor, capacitor, etc. A component in CADDS is represented by a nodal 
subfigure. 

Component A physically identifiable element of a component. Component elements 

Element are actually part of the component but are drawn as separate symbols, 


e.g., split-equipment (also called an element). Examples include contact, 
coil of relay, and switches of a circuit breaker. A component element in 
CADDS is represented by a nodal subfigure. 


Component Label Text associated with a component which identifies the component. In 
CADDS, a component label is nodal text attached to a text node 
associated with the component nodal subfigure. It may also be called 
Component Name. 


Component Layer The layer of the schematic containing component names (such as R1, D2, 
etc). A CLAY modifier may be used with the LST NET command, default 
is layer 2. 


Component Name The reference designator placed on a PC component and on the cor- 
responding element in the schematic drawing. 


Computer An interconnection of computer systems, terminals, communications 
Network facilities, and data collecting devices. 
Concentrator A communications device that provides communications capability 


between many low-speed, usually asynchronous channels and one or 
more high-speed, usually synchronous, channels. !t’s normal for different 
speeds, codes, and protocols to be accommodated on the low-speed side. 
The LS channels usually operate in contention and require buffering. The 
concentrator may have the capability to be polled by a computer, and may 
itself poll terminals. 


Conditioning The addition of equipment to leased voice-grade lines to provide specified 
minimum values of line characteristics required for data transmission e.g., 
equalization and echo suppression. 


Configuration The combination of computer and peripheral devices at a single area of 
installation. 

Connect Node A location shown graphically as a diamond (<>), used as an attachment 

CNOD point for nodal lines. Connect nodes may have text nodes associated with 


them. Connect nodes are often associated with a nodal subfigure. 
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Contention Circumstance of having several processes simultaneously requesting 
exclusive use of a single resource (such as a disc), or communications 
channel. 

Control Character 1. A character whose occurrence in a particular context initiates, 


modifies, or stops a control function. 


2. In ASCII, any of the 32 characters in the first 2 columns of the standard 
code table. Ten of these characters form the basis for character- 
oriented communications control procedures. 


Control Signals Pulses that control the operation of components: enable components, 
clock-in data, select multiplexer outputs, and initiate operations. 


Control Station The station on a network which supervises the network control procedures 
such as polling, selection, or recovery. It is also responsible for establishing 
order on the line in the event of contention (or any other abnormal situa- 
tion) arising between stations on the network. See also Tributary Station 
for comparison. 


Controller Unit The PC board (or boards) that control an |/O device and interface with the 
main processor. 


Core Layout/ The manner in which a CADDS user’s core memory is used for program 
Overlay execution. 
Coreload A program, series of programs or data which can be executed and/or 


accessed directly. 


CPS Characters Per Second or Cards Per Second. 

CPU Central Processing Unit. 

Crash A system or program malfunction that causes the system to stop opera- 
tion. 

Cross Section Cutting at an angle to the axis. The view formed when a plane is passed 


through a part and everything on one side of the plane is discarded. 
Crosshatching The process of filling in an outline with a pattern. 


Crosstalk The undesired transfer of energy from one circuit, called the disturbing cir- 
cuit to another circuit, called the disturbed circuit. 
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CRT 


Cubic 


Cursor 


Curve 


Cut Plane 


CVNET 


CVNET Il 
Cyclic Redun- 
dancy Check 
(CRC) 

Data 


Data Access 


Cathode Ray Tube: An electronic device in which a well-defined and con- 
trollable beam of electrons is produced and directed to a surface to give a 
visible display. 


Relating to the third dimension, a cube. A cubic curve or equation. An 
algebraic expression of one variable which employs that variable, its 
square, and its cube, summed in any combination, each having any co- 
efficient. 4t3 + 7t2 + 8t + 6 is a cubic equation in t with coefficients 4, 7, 
8 and 6. 


Movable, visible mark used to indicate a position for the next unit of input 
to a display. On a CRT, the cursor indicates the position controlled by the 
stylus. 


Path of a moving point. 


The ability to define a plane and to intersect that plane with a three- 
dimensional object in order to derive a sectional view. 


Computervision proprietary protocol for file transfer between CV Designer 
systems. A bisynchronous ASCII protocol. 


Computervision’s protocol for use with Computervision’s PC board. © 

An error detection scheme in which the BCC is generated by taking the 
mainder after dividing all the serialized bits in a block of data by a preset 
binary number. 


Any meaningful pattern of bits. Data can be addresses or operands. 


Data communications equipment furnished a common carrier or indepen- 


Arrangement dent manufacturer, permitting attachment of privately-owned data com- 
(DAA) munications equipment to the common carrier switched network. 

Data Circuit 

Terminating See Data Communications Equipment. 

Equipment 


Data Collection 


Data 


Communications 


Data 


Communications 
Equipment (DCE) 
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The act of moving data from one or more points to a central point. 


The interchange of data messages between two points over communica- 
tions channels. 


The equipment which provides the functions required to establish, main- 
tain, and terminate a connection, the signal conversion and coding 
required for communication between Data Terminal Equipment and data 
circuit. DCE may or may not be an integral part of a computer, e. g., a 
moden. | 
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Data Collection of data at an intermediate point from several low-and medium- 
Concentration speed lines for retransmission across high-speed lines. 

Data Integrity A performance measure based on the rate of undetected errors. 

Data Link Control A uniform discipline for the transmission of data, over a single communica- 


tions link. The three types of DLCs include: 


character controlled protocols BCP’s 


character count protocols CCP’s 
bit-oriented protocols BOP’s 
Data Phone As a trademark as well as a service mark of AT&T, it identifies the data 


sets or modems manufactured and supplied by the Bell system for use in 
data transmission over the regular telephone network. As a service mark, it 
identifies the transfer of data over the regular telephone network. 


Data Set A modem, also a collection of data records, with a logical relation of one to 
another. 
Data Tablet Input device which has a writing surface with direct correspondence 


between positions on the tablet and addressable points on the display 
surface of a CRT. 


Data Terminal 1. The equipment comprising the data source, data sink, or both. 
Equipment 2. Equipment usually comprising the following functional units: 


control logic 

buffer storage 

one or more |/O devices or computers 
error control facilities 

synchronization capability 

station |.D. capability 


Data The sending of data from one place for reception elsewhere. See Data 

Transmission Communication for comparison. 

Database Collection of information organized for rapid search, retrieval, and 
operation. 

Database Linkages within the CADDS database which logically bind two or more 

Relations elements in the database. For example, a nodal line (interconnect) is 


related to its terminal connection nodes (pins) since they all belong to the 
same electrical net. 
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Dataphone 
Digital Service 
(DDS) 
Dataphone 50 


DCP 


DDCMP 


DDEX 


Debug 


Default 


Default Selection 


Delay Distortion 


Delimiter 


Demodulation 


Design Console 


Device 


Diagnostics 


A communications service of AT&T in which data is transmitted in digital 
rather than analog form, thus eliminating requirements for modem 
devices. 


A public switched-communications service of the Bell system featuring 
high-speed data communications at 50KBPS. 


Data Communications Processor. 


Digital Data Communications Message Protocol by Digital Equipment 
Corportion (DEC). The best example of a CHARACTER COUNT protocol. 
Method of physical data transfer used may be parallel, serial synchronous, 
or serial asynchronous. 


Diagnostic Disc Executive: A monitor, same as DTEX, but resident on 
disc. 


A process used to eliminate errors from a computer program. 


The value of a required parameter or argument not specifically supplied by 
the user. 


A process that allows a CADDS 4 user to select global (default) parameters 
which are then used each time a command is given. For example, SEL 
TEXT HEIGHT 0.156 will cause all text subsequently added to the drawing 
to be 0.156 inches high. The operator can override this default by selecting 
a different height at intersection time. 


Distortion resulting from non-uniform transmission speed of the various 
frequency components of a signal through a transmission medium. 


A character that separates and organizes different elements of data. 

The process of retrieving an original intelligence signal from a modulated 
carrier wave. This technique is used in data sets to make communications 
signals compatible with computer signals. 


The CV trade name for an interactive terminal. 


A piece of |/O equipment (such as a magnetic tape or disc drive) external 
to the CGP chassis. 


Programs that evaluate, test, and identify the status of computer com- 
ponents. 
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Dial-Up Line A communications circuit established by a switched circuit connection. 
Digitize The process of specifying data points on an interactive surface. 
Digitizer Device providing input coordinate data by pointing. Digitizers are used in 


Direct Distance 
Dialing (DDD) 


Direct Memory 
Access (DMA) 


converting a drawing or image to digital form. 


A telephone exchange service which enables a user to dial telephone 
numbers outside his local calling area without operator assistance. 


A logical control facility which permits |/O data transfers between a 
peripheral device directly into or out of memory without host computer 
intervention handling or control. 


Disc An auxiliary storage device on which information can be read or written. 

Display Visual presentation of data. See CRT. Basic building symbols that con- 
struct display images (i.e., points, line segments, and characters). 

Display Menu An option allowing an operator to select the next action by indicating one 
or more choices with an input device. 

DLE Data Link Escape. A control signal used exclusively to provide supplemen- 
tary line-control signals. These are two character sequences where the first 
character is a DLE. The second character depends upon the desired func- 
tion and the code used. 

DMA Direct Memory Access or the interface board used to control specified 


Double Precision 


peripheral devices. 


The technique of allocating twice the storage space and increasing the 
computing time to achieve twice the accuracy. 


DPU Disc Processing Unit: A disc-processing controller. 

Drawing A graphic representation of data. 

DRC Design Rules Checking: A process used to check a printed circuit board for 
manufacturing tolerance violations. Rules checked include: pad-to-pad, 
pad-to-interconnect, and interconnect-to-interconnect spacing. 

Drill Symbol A symbol that indicates a particular size drill to be used in a drill template. 

Drill Tape A magnetic or paper tape which contains information to be fed into an NC 


drill machine. 
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Diagnostic Tape EXecutive: A comprehensive, tape-resident, diagnostic 
monitor for loading and testing CV system installations, automatically, off- 
line. 


A type of geometric design rules check in which 2 different entities (such 
as, pads vs. lines or lines vs. other lines) are checked for the distance 
between them (gaps) or overlaps. 


Simultaneous two-way independent transmission in both directions. Also 
referred to as Full Duplex or FDX. 


With storage tube technology, it is necessary to repaint the display com- 
pletely when any element of the picture is changed. Dynamic editing 
allows the user to define a simple picture (symbol) which can be displayed 
in write-through mode and moved around without storing on the CRT. 


Eight-bit (256 combinations) character code used primarily in IBM equip- 
ment. 


A portion of the transmitted signal returned from the distant point to the 
source with sufficient magnitude and delay so as to cause interference. 


A procedure whereby the receiving station automatically retransmits each 
character received, so that the sender may verify the correctness of his 
transmission. 


A device used to attenuate or cancel the effects of an echo on the line. 


To alter, adapt, or redefine to achieve conformity to a standard, or to suita 
particular purpose. 


The address obtained from indexing or indirect addressing operations. The 
EFA specifies an operand or instruction, not another address. 


An Electronic Industries Association character code commonly used in 
computer applcations. 


A symbol used in a schematic diagram to represent a particular logical or 
physical function, such as an AND gate or a resistor. 
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Diagram 


Electronic 
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Electronic 
Switching 
System (ESS) 


ENO (Enquiry) 


Entity 


EOT (End of 
Transmission 


Equalization 
Equivalent 


Elements 


Equivalent Pins 


Erase 


Error Control 


ES 


An electrical schematic diagram containing components, logic elements, 
wire nets, bullets, miscellaneous graphic and non-graphic information, and 
text annotation. It may also be called a ‘Wiring Elementary.”’ 


A standards organization specializing in the electrical and functional 
specification of interface equipment characteristics. 


The common carrier communications switching system which uses solid- 
state devices and other computer-type equipment and principles; in par- 
ticular, systems provided by the Bell System. 


Used as a request (for response) to obtain identification and/or an indica- 
tion of station status. In BISYNC transmission, ENQ is transmitted as part 
of an initialization sequence (line bid) in point-to-point operation, as the 
final character of a selection or polling sequence in multipoint operations, 
and as a text abort. 


CADDS terminology for a primitive graphics item, i.e., arc, circle, line, 
text, point, spline, figure, nodal line, etc. | 


Indicates the end of a transmission which may include one or more 
messages, and resets all stations on the line to control mode (unless it 
erroneously occurs within a transmission block). 


Compensation for the increase of attenuation with frequency. Its purpose 
is to produce a flat frequency response. 


Two equivalent elements or subcom ponents which can be used inter- 
changeably and still retain an electrically correct circuit. 


When an interconnect for a specific signal may be connected to any one of 
electrically equivalent pins and still be electrically correct. For example, the 
input pins of a two input AND gate are electrically equivalent pins. 


To remove from existence. 

An arrangement which detects the presence of errors. In some systems, 
error correction or recovery circuits are included; these either perform 
direct operations on received data, or request retransmission from the 


source. 


Electrical Schematic. 
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ETX (End of Text) Indicates the end of message. If multiple transmission blocks are contained 


Exchange 


Execute Cycle 


Extents 


Facsimile (FAX) 


Fetch Cycle 


FIFO 


Figure 


File 


Fillet 


Fillet Surfaces 


Finite 
Element/Mesh 
Generation 


in a message in BSC systems, ETX terminates the last block of the 
message. (ETB is used to terminate preceding blocks.) The block check 
character is sent immediately following ETX. ETX requires a reply 
indicating the receiving station’s status. 


A defined area, served by a communications common carrier, within 
which the carrier furnishes service at the exchange rate and under the 
regulations applicable in that area as prescribed in the carrier's filed tariffs. 


The microcycle (DECODE 1, RAD 2A) that begins the execution of an 
instruction by decoding It. 


The limits to which something extends; the amount of space or surface 
that something occupies or the distance over which it extends. 


Transmission of pictures, maps, diagrams, etc. The image is scanned at 
the transmitter, reconstructed at the receiving station, and duplicated on 
some form of paper. 


The cycle during which an instruction is read out of memory and sent to 
the CPU. 


First-In-First-Out memory buffer. 


An alternate terminology for a symbol or a part, and may contain primitive 
entities, other figures, non-graphic properties, and associations. Figures 
may be stored together in one library called a figure library, a parts library, 
or a symbol library. 


A logical collection of data treated as a unit, which occupies space on a 
storage device such as a disc or magnetic tape and has an associated 
filename and file type. 


The arc of concave junction formed where two entities meet a curve that 
blends two curves or two lines. 


The name given to the transition surface which blends two other surfaces 
together. An example of a fillet surface is the surface which blends the 
wings of an airplane to the plane’s body. 


Finite element analysis is an engineering method for determining the struc- 
tural integrity of a mechanical part. Mesh generation is a means of creating 
the data necessary in order to apply finite element analysis programs. 


Firmware 
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Floating Point 


Font 


Format 
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A blend of hardware and software characteristics. 


A variable or register used to record the status of a program or device; the 
noting of errors by a translating program. 


A number system in which the position of the radix point is indicated by 
the exponent part and another part represents the significant digits or frac- 
tional part. 


An assortment of type all of one size and style. A text font is a complete 
character set of one size and style. A line font is repetitive pattern used to 
give meaning to a line. 


A general plan of organization or arrangement. It is also the specific 
arrangement of data. 


The CV version of FORTRAN IV. FORTRAN is an acronym for FORmula 
TRAWNslation and is a high-order programming language used primarily for 
scientific or algebraic applications. 

A data transmission channel in which the direction of transmission coin- 
cides with that in which information is being transferred. Compare with 
Reverse Channel. 

Field-Programmable Logic Array. 


See Block 


CRC remainder transmitted at the end of a frame. 


Dividing the available transmission frequency range into narrower bands, 
each of which is used for a separate channel. 


Multiplexing (FDM) 


Frequency 
Modulation (FM) 


Frequency Shift 
Keying (FSK) 


A method of transmission whereby the frequency of the carrier wave is 
changed to correspond to changes in the information signal wave. 


Also called frequency shift signalling. A method of frequency modulation 
in which frequency is made to vary at significant instants by smooth as 
well as abrupt transitions. Typically, a data “1” bit is represented as one 
frequency and a data ‘’O” as another frequency. 
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Front End A communications computer associated with a host computer. It may per- 

Processor form line control, message handling, code conversion, error control, and 
applications functions such as control and operation of special-purpose 
terminals. 

Full Duplex In communication, this term pertains to a simultaneous, two-way indepen- 


dent transmission. 
Full-Duplex (FDX) See Duplex. 


Function Key A button or switch which enters commands or other keyboard input, I.e., 
each choice of a display menu. 


Gap The length of the shortest line segment which can be drawn from the 
boundary between two entities. 


GAPS Graphics Application Programming Subroutines. 


Generation A type or a class of objects developed from an earlier type; an aged version 
within a family. 


Geometric Design Rules relating to the geometry of a PC board. A text file is used to specify 
Rules rules for the CHK PRT command and the items checked include gap, 
overlay, and width. 


Geometry The collection of lines, circles, points, etc., and their special relationship. 


Getdata The interface through which all CADDS commands receive data from the 
oprator and issue prompts if appropriate. Input to Getdata may include 
digitized points, explicitly typed X, Y, and Z coordinates, or references to 
other CADDS 3 graphic entities. 


GIS Graphics Information System. 
GPU Graphics Processor Unit. 
Graphics I/O Graphics Input/Output provides general interface to all graphic devices 


supported by CADDS 3. It can allow new graphic devices to be added to 
the system easily, and permits multiple graphic devices to function 
together. For example, while digitizing, resulting graphics are echoed on 
the display. 


Grid A network of uniformly spaced points which may appear on an output 
device, and are used to locate positions. 


Grid Size 


Half-Duplex 
(HDX) 


Hard Copy 


Hard Core 


Hardware 


Header 


Hertz 


Hexadecimal 


Hidden Lines 


High Level 
Data Link 
Control (HDLC) 
High Order Bits 


Homogeneous 


Horizontal Layer 


Host Computer 
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The spacing of grid points. 


A circuit designed for transmission in either direction but not both direc- 
tions simultaneously. 


A copy on paper of an image displayed on a CRT display. 


That portion of an equipment that must work in order for a diagnostic 
routine to be effective. 


The physical equipment components of a computer system, e.g., 
mechanical, magnetic, electrical, or electronic devices. Hardware is in 
contrast to software. | 


The control information prefixed in a message text, e.g., Source or destin- 
tion code, priority, or message type. Also called heading and leader. 


A unit of frequency equal to one cycle per second. Cycles are referred to as 
Hertz in honor of the experimenter, Heinrich Hertz. Abbreviated Hz. 


The number system with a radix of sixteen in which the numbers are 
represented as 0-9 and A-F. For example, 11 decimal is B hexadecimal. 


Line segments that would be obscured from view in a orthographic projec- 
tion of a three-dimensional object. 


ISO version of bit-oriented data link control. Functionally identical to ADC- 
CP. 

The most significant bits in a data word. 

Of uniform structure or composition throughout. 


The layer of the PC board drawing which contains the connections that are 
predominately horizontal. 


A computer attached to a network providing primary services such as 
computation, database access, special programs, or programming 
languages. 


Integrated Circuit: A tiny complex of electronic components and their con- 
nections produced on a small slice of material such as silicon. 
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ICP 


incremental 
Coordinates 


Indirect Address 
Information 


Initialize 


Input 


Input/Output 
Device 


Insert 
Instaview 


Instruction 


Interact IV (IAIV) 


Interactive Node 
and Element 
Definition (INED) 


Interconnection 
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Intelligent Control Panel. 


A new set of coordinates measured from a previously derived set of coor- 
dinates rather than from the origin of XO, YO, ZO. 


Specifies a storage location containing either a direct or effective address 
or another indirect address. 


A pattern of bits that contains, or is decoded into, data, addresses or 
operands. 


To set counters, switches, or addresses to starting values at prescribed 
points in the execution of a program, particularly for re-execution of a 
sequency of code. 


The data to be processed; the process of putting data into a system. 


A device attached to a computer that makes it possible to enter informa- 
tion into the computer or to get information out of the computer 


The action of placing entities, figures, or information into a part. 
A television-type graphics terminal. 


A coded command that tells the computer what to do and where to find 
the values it is to work with. A symbolic instruction looks more like 
ordinary language and is easier to deal with. Symbolic instructions, 
however, must be changed into machine instructions, usually by another 
program, before they can be executed by the computer. 


The CV name for an automated drafting table used to plot and/or digitize 
drawings. 


The capability which gives the CADDS user the ability to interactively 
create a finite element mesh. Post-processors can convert the CADDS 
database into formatted input for finite element programs. The acronym 
INED is used and is pronounced as INEED. 


Anything that connects one item to another. On a PC board, interconnec- 
tions consist of copper runs connecting pads. On schematic drawings, 
interconnections consist of lines connecting elements. In CADDS draw- 
ings, all interconnections are made with nodal lines. 
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Interface 


Interface Unit 


Interrupt 


Intrinsic 
1/O 


lOS 


IPC 

IPS 

ISO (Interna- 
tional Standards 
Organization) 
ITB (Intermediate 
Text Block 


Justification 


Keep-out 


1. A shared boundary defined by common physical interconnection 
characteristics, signal characteristics, and meanings of interchanged 
signals. : 


2. A device or equipment making possible interoperation between two 
systems, e.g., a hardware component or a common storage register. 


3. A shared logical boundary between two software components. 
The PC board (or boards) that allow |/O devices to communicate with the 
main processor. Interface units hold and transfer data as directed by |/O 


instructions. 


A signal that, when activated, causes a transfer of control to a specific 
location in memory, thereby breaking the normal flow of execution. 


Belonging to the essential nature or constitution of a thing. 
Input/Output. 


Input/Output System; the board used to interface several types of 
peripheral devices. 


Institute of Printed Circuits. 
Inches Per Second. 


ANSI reports to ISO. 


In binary synchronous communications, a control character used to 
terminate an intermediate block of characters. The block check character 
is sent immediately following 1TB, but no line turnaround occurs. 


The exact placement of an item. Text may be left-, center-, or right- 
justified depending upon whether the digitized point is to appear to the 
left, in the center or to the right of the text. If a string is left- justified, the 
digitized point will lie on the left edge of the string at a width when facing 
in the same direction as the string. 


Nodal lines or strings that define the boundaries of a PC board and the area 


inside of the board not to be used for routing. Currently used only by 
Autoroute. 
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Language A set of representations, conventions, and rules used to convey informa- 
tion. 
Layer A logical concept used to discriminte or separate group(s) of data within a 


given drawing. Layering enables an operator to specify derived display 
elements to be visible. A layer may be thought of as a series of transparen- 
cies arranged in any order, yet having no depth. Layering allows a more 
efficient use of the database. 


Leased Line A line reserved for the exclusive use of a leasing customer without inter- 
exchange switching arrangements. Also called a private line. 


Least Significant The last value bit in a data word. See most significant bit. 
Bit (LSB) 
Library A collection of files, such as the CD3PRTS library which contains all the 


CD3PRTS files. 


Limited Distance A lower cost modem intended for limited distance operation. Also called 
Modem short-haul modem. | 
Line 1. The portion of a circuit external to a device consisting of the conduc- 


tors connecting a telegraph or telephone set to the exchange or con- 
necting two exchanges. 


2. The group of conductors in a cable. 


Line Font A line font is a special pattern used to represent a line. Line font as a view 
is the ability to define specific graphic representations for CADDS entities 
which are view-independent. For example, a line may be solid when drawn 
in the top view of an object but becomes dotted in the side view where it is 
not normally visible. Thus the line’s font is view-dependent. 


Link 1. Any specific relationship between two nodes in a network. 
2. A communication path btween two nodes. 
3. A data link. 


Unites two or more separately written and compiled subroutines into a 
single unified operational unit. 


Link/Unlink A command that allows the user to link NC machine toolpaths together 
and to subdivide toolpaths by unlinking. 
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LIS 


LMOS 


Load Module 


Loader 


Location 


Logic Element 


Logical Address 


Longitudinal 
Redundancy 
Check (LRC) 


Loop 


Loops and 
Macros 


Low Order Bits 


Large Interactive Surface: An automated drafting table used to plot and/or 
digitize drawings. 


Large Memory Operating System. 


A load module is a program in a format suitable for loading into main 
storage for execution of system commands. 


A program used to link object modules into a form suitable for loading into 
memory and for execution. 


An address in memory where a unit of data or an instruction can be stored. 


A symbol which has logical meaning. It may also be called a logic symbol. 
Logic elements in CADDS are represented by nodal subfigures. Examples 
of logic elements include AND gates, OR gates, flip-flops, etc. 


The address specified by the CPU. 


An error checking technique based on an accumulated exclusive OR of 
transmitted characters. An LRC character is accumulated at both the 
sending and receiving stations during the transmission of a block. This 
accumulation is called the Block Check Character (BCC), and is trans- 
mitted as the last character in the block. The transmitted BCC is compared 
with the Accumulated BCC character at the receiving station for an equal 
condition. An equal comparison indicates a good transmission of the 
previous block. 


A sequency of instructions which are executed repeatedly, with or without 
modifications during each iteration, until a terminating condition is 
satisfied. 


Provide the capability to create a set of NC toolpath cuts based on the 
same geometry, but differing in thickness offset. The user needs only to 
create the basic toolpath definition. The system then uses this macro to 
subsequently create a set of cuts by varying the offset parameter. 


The least significant bits in a data word. 


LSI (Large Scale 
Integrated Circuit) 


See UART, USART, USRT. 
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MABS 
Associativity 


Machine 
Instruction 


Machine Language 


Macros 


Magnify 


Main Processor 


Maintenance 


Control Panel 


Make File 


Map 


MARK 
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Mass Properties 


Mass Storage — 


Master Station 
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The ability to recall the steps used in deriving an absolute machining 
(MABS) toolpath such that a revised toolpath can be automatically 
regenerated after changes occur to the part’s geometry or to the tool’s 
descriptions. Thus, the MABS toolpath is associated with the part’s 
geometry. 


An instruction that a machine can recognize and execute. A code that 
directs a computer to perform a particular operation. 


The actual language used by the computer when it performs operations. 


A prewritten set of statements which acts as an internal subroutine and 
which processes data passed to it in a specified fashion. 


Enlarge in appearance. 


The two units that function together to execute instructions: the CPU and 
memory units. 


The inner control panel of the CGP used for maintenance and diagnostics. 


A text file containing commands to the system loader which controls the 
way the load module is created. In this sense, the load module is the same 
as a coreload. 


The configuration of physical addresses. To convert logical addresses into 
physical addresses. 


Presence of a signal. In telegraphy, MARK represents the closed condition 
or current flowing. Equivalent to a binary one. 


A combination of bits used to select specific portions of any word, 
character, byte, or register for further processing. 


The generic term used for the calculation of physical engineering informa- 
tion about a part. Examples of mass properties include perimeter, area, 
volume, weight, moments of inertia, etc. 


Pertains to a device that can store large amounts of data readily accessible 
to the computer, i.e., a disc or magnetic tape. 


See Primary Station. 


The information and drawings contained herein are the sole property of Computervision 
Corporation. Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
express written consent of Computervision. 


MCP 
MD 


MDB Board 


MD/NC 


Memory 


Memory Cycle 


Memory Unit 
Menu 


Mesh 


Message 


Message Switching 


Microdiagnostics 


Microinstruction 


Microprogramming 


Minus Figure 


Maintenance Control Panel. 
Mechanical Drafting 


A multiple |/O board in the CGP main-frame used to interface several types 
of peripheral devices. 


Mechanical Drafting/Numerical Control. 


Any form of data storage, including MOS memory and mass storage, 
where data can be read and written. Usually, however, memory refers to 
MOS memory. 


The amount of time required to read out of or write into a memory location 
(usually 400 ns). 


The PC board(s) that store data for the CPU. 
The graphics used to guide the operator to the correct function key. 


A network of Ines used to represent or display a surface. A mesh appears 
as two sets of parallel curves, each set parallel to the surface boundaries, 
one set intersecting the other. 


A communication from the system, e.g., an error message. 


A method of handling messages over communications networks. The 
entire message is transmitted to an intermediate point (e.g., a switching 
computer), stored for a period of time, perhaps very short, and then 
transmitted again towards its destination. The destination of each 
message is indicated by an address integral to the message. Compare with 
Circuit Switching. 


Microprograms residing in the control store that test the operation of the 
CPU. 


An instruction that controls an elementary CPU operation. A series of 
microinstructions, called a microroutine, execute each instruction. Each 
microinstruction defines a machine state (microcycle). 

The use of microinstructions to execute instructions. 

Any CADDS part that contains a minus sign (— ) as the first character of its 


name. Minus figures are treated as connection points but are not normally 
listed in a net list and are not considered components or elements. 
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MIPTR 


Mirroring 


MMPU (Mapper) 


Mnemonic 
Model Space 
Modem 


Monitor 


MOS Memory 


Most Significant 
Bit (MSB) 


Move 
Modem (Modulator- 
Demodulator) 


Multi-Private Line 
Service (MPL) 


Multi-User 
Controller (MUC) 


Multiplexer 
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Master Index Pointer: The MIPTR provides a means of obtaining informa- 
tion rapidly from a specific entry in the parts database. 


A graphic action which causes a construction to be represented in a 
reversed arrangement in comparison to the original with reference to an 
intervening axis. 


Memory Mapping and Protection Unit or mapper module in the CGP used 
to access memory above the first 32K. 


An alphabetic representation of a function or a machine instruction. 
Frame of coordinate reference for the graphics database. 
A device that modulates signals transmitted over communications circuits. 


A device (hardware or software) that observes and verifies the operations 
of a data-processing system and indicates any significant departure from 
the norm. 


Metal Oxide Semiconductor memory, the main type of memory used in the 
CGP-100 as well as in many other computers. 


The first value bit in a data word. The MSB defines the order for the rest of 
the word. For example, if bit 0 is the MSB, then the word 1 011 011 000 111 
000 is read from left to right as 133070. If bit 15 is the MSB, then the word 
is read from right to left as 016155. 


An action causing a graphics construction to change position relative to 
the remainder of the drawing or part. 


A device that modulates and demodulates signals transmitted over com- 
munications circuits. Also called data set. 


A wideband service of 48 kHz bandwidth. 


The obsolete name for the Memory Management and Protection Unit 
(MMPU). 


A device used for multiplexing. It may or may not be a stored program 
computer. Also a device for connecting a number of communications lines 
to a computer. 
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Multiplexing A division of a transmission facility into two or more channels. See also 
Frequency Division Multiplxing and Time Division Multiplexing. 


Multipoint Line A single communications line to which more than one terminal is attached. 
Use of this type of line normally required some kind of polling mechanism, 
addressing each terminal with a unique ID. Also called multi-drop. 


Narrowband Sub-voice grade channels characterized by a speed range of 100 to 200 bits 
Channels per second. 
NASTRAN NASA STRuctural ANalysis: a structural analysis program developed to 


run on large computers. 


NC Numerical Control: Automatic control of machine tools, drafting 
machines, and other operations by punched paper or magnetic tapes 
suitably formatted with directive information. 


NC Drilling Automatic control of drilling machines by punched paper or magnetic 
tape, suitably formatted for drill operation. | 


NC Insertion Automatic control of machines which place physical components on a PC 
board or those machines which direct the placement. 


NC Pep The addition of NC toolpaths and other programming capabilities to the 
CV PEP processor. This allows CV users to develop special NC capabilities 
and libraries of simple NC programs to support various NC tools. 


NC Toolpath Edit The ability to react to design changes by modifying selected portions of an 
NC toolpath without recreating the entire toolpath. 


Negative Indicates that the previous transmission block was in error and that the 
Acknowledgement receiver is ready to accept a retransmission of the erroneous block. NAK 
(NAK) also indicates the ‘‘not ready” reply to a station selection (multipoint) or to 


an initialization sequency (line bid) in point-to-point operation. 


Net A set of symbols which are logically connected. A net may also contain 
bullets. In CADDS 4, a net is represented by nodal lines attached to con- 
nect nodes associated with nodal subfigures. It may also be called a 
Logical Net. 


Net List A list of names, symbols, and their connection points which are logically 
connected to a net. Bullets are not listed. 
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Manual layouts of printed circuit board interconnects are prone to error in 
their electrical equivalence to the logical schematic. Net List Verify 
compares the net list of the schematic to the net list of PC board and 
reports any errors. | 


Alphanumeric designation of a net. In CADDS 4, a net name is nodal text, 
or properties, associated with a nodal line. 


Two or more processors connected via communication lines for the 
exchange of information. 


Four bits of a data word. (See Byte.) 


A class of entities required for wiring diagrams which contain associative 
relationships between the entities, i.e., nodal line, nodal text, nodal sub- 
figure, connect node, and text node. 


A string which must begin and end on a connect node. Nodal text, usually 
a signal name, may be associated with a nodal line. 

A figure inserted into an active figure as a ‘‘nodal’’ subfigure. Nodal infor- 
mation is copied from the original figure into the active part but continues 
to be associated with the subfigure. 


Text associated with a text node or nodal line. Any number of text entities 
may be associated with a single text node or nodal line. 


Undesirable distrubances in a communications system. Noise can generate 
errors in transmission. 


A coding scheme that inverts the binary signal state on a ZERO and leaves 
it unchanged on a ONE. 


A communications link permanently installed between two points. Also 
called leased line or private line. 


Transmission of characters in a defined character format, e.g., ASCII or 
EBCDIC, in which all defined control characters and control character 
sequences are recognized and treated as such. 


See scale. 


nanosecond. 
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Object Module An organized, programmed, sequence of machine instructions generated 
by a compilation of a source file. 


Octal The number system based on a radix of eight, for example, octal 8 is 
decimal 10. 
Off-line Equipment or devices in a system which are not currently under the direct 


control of the system. 


Offset Origin The distance from the origin of a part to the point referenced by the N/C 
inserter. 
On-line Equipment or devices in a system which are currently under the direct 


control of the system. 


One-Way Only A mode of data link operation in which data are transmitted in a preas- 
Operation signed direction over one channel. Also called simplex operation. 


One’s Complement A number formed by interchanging the bit polarities in a binary number, 
e.g., 1 becomes 0 and O becomes 1. 


Operation The action specified by a single computer instruction; a program step 
undertaken or executed by a computer, e.g., multiplication, comparison, 
addition, etc. The operation is usually specified by the operator part of an 


instruction. 
Order To place into a sequence according to some rules or standards. 
Origin The X0, YO, ZO point from which all coordinates are measured. 
O/S Operating System. 
Output The result of a process; the transferring of data from internal storage to 


external storage. 


Overflow A condition that occurs when a mathematical operation yields a result 
whose magnitude is larger than the program is capable of handling. 


Overlap One of the types of checks performed by the CHECK PART graphics com- 
mand. An overlap can also refer to the shortest line segment which can be 
drawn from a boundary of one figure inside a second figure across overlap- 
ping space to the nearest boundary of the second figure. 
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A data transmission process, utilizing addressed packets, whereby a chan- 
nel is occupied only for the duration of the packet transmission. NOTE: In 
certain data communication networks the data may be formatted into a 
packet or divided and then formatted into a number of packets (either by 
the data terminal equipment or by equipment within the network) for 
transmission and multiplexing purposes. See also Circuit Switching and 
Message Switching. 


An area of plated copper on a PC board to which leads of components are 
soldered. Plus figures are used to represent pads in CADDS. 


The transfer of data one word or byte at a time. 
Method of data transfer in which all bits of character or byte are trans- 
mitted simultaneously either over separate Communication lines or on 


different carrier frequencies on the same communication line. 


A binary digit appended to an array of binary digits to make the sum of all 
the bits always odd or always even. 


Addition of non-information bits to data, making the number in each 
grouping of bits either always odd for odd parity or always even for even 
parity. This permits single error detection in each group. 

Another word for drawing. 

A name that definitely identifies a part (such as 7227). 

In the creation of a PC board from an electrical schematic, partitioning 
refers to the logical grouping of electrical functions within a given set of 
hardware components. Placement refers to the physical location of the 
hardware components on the PC board. CADDS 4 provides tools to 
automate this process. 

Printed Circuit: A circuit for electronic apparatus made by depositing con- 
ductive material in continous paths from terminal to terminal on an 
insulating surface. (Also Program Counter.) 

Printed Circuit/Electrical Schematic. 


Programmable Communications Unit. 


A display terminal connected to a debug port on the PCU board. 
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Pen 


PEP 


Peripheral Device 


PFK 
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(PM) 


Photoplot 


Photoplotter 


Photoplotter Wheel 


Physical Device 


Pin 


Pin Name 


Placement 


Plane 


Plus Figure 


Point 


A drawing implement. Sometimes called a stylus. 


Parametric Element Processor: a language for defining a graphics 
database. 


Any device distinct from the computer which can provide input to and/or 
accept output from the computer. 


Program Function Keyboard. 


A method of transmission whereby the phase angle of the carrier wave is 
varied in accordance with the signal. 


A photograph of printed circuit board graphics used for a particular pro- 
cess. For example, separate photoplots are used for etching each side of a 
circuit board. 


A device used to perform photoplot functions. 
A wheel in a photoplotter containing aperatures of various sizes and 
shapes through which light must pass to reach the film. It is also referred 


to as an aperature wheel. 


An I/O or peripheral storage device connected to or associated with a 
computer. 


A connection point for components and logical elements. In CADDS, a pin 
is represented by a connect node associated with a nodal subfigure and 
may also be referred to as a connector on a component. 

An alphanumeric designation assigned to a pin. In CADDS, the pin name 
is nodal text attached to a text node associated to the pin connect node. It 
may also be called pin number when it is Just a numeric designation. 


The assignment of something to a suitable place or location. 


A surface of such nature that a straight line joining any two of its points lies 
wholly in the surface. 


A CADDS part with a name beginning with a plus (+) sign. Plus figures 
are used by the photoplotter processor. Each figure refers to a particular 
aperature on the photoplotter wheel. 


A narrowly localized place having a precisely indicated position. 
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1. A network configuration in which a connection is established between 
two terminal installations. The connection may include switching 
facilities. 


2. Acircuit connecting two points without the use of any intermediate ter- 
minal or computer. Compare Multipoint Connection. 


The process of inviting another station or node to transmit data. Compare 
with Selecting. 


A closed plane figure bounded by straight line segments. 


Reading a word out of the top location of the next address logic stack, 
thereby popping each word up to the next location. 


A port enables graphic information to be transferred in or out of the 
database. Each port is associated with only one command device. 


A postprocessor is that program or procedure which processes NC data 
and formats it into data readable by a specified machine. 


Runs or lines that are placed on a PVC board before using Autoroute. 
Lines may be inserted using specified graphics commands and, in CADDS, 
they are represented as nodal lines. 


A preprocessor is that program or procedure which process a toolpath to 
generate a numeric record. 


1. The station which at any given instant has the right to select and to 
transmit information to a secondary station, and the responsibility to in- 
sure information transfer. There should be only one primary station ona 
data link at one time. 


2. Astation which has control of a data link at a given instant. The assign- 
ment of primary status to a given station is temporary and is governed 
by standardized control procedures. Primary status is normally con- 
ferred upon a station so that it may transmit a message, but a station 
need not have a message to be nominated primary station. 


Not derived assumed as a basis at the lowest stage of complexity. 
A ranking associated with a task or machine operation defining the 


preference of its requests for service received from the operating system 
relative to other tasks or operations requesting service. 


Process 


Processor 


Program 


Program Counter 
(PC) 


PROM 


Prompt 


Properties 


Protocol 
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A series of actions or operations performing a function that is leading or 
leads to an end result. 


In hardware, it is the CPU. In software, it is a computer program that 
includes the compiling, assembling, translating, and related functions for a 
specific programming language or application. 


A set of machine instructions or symbolic statements combined to perform 
some task. 


A register used by the CPU to record the locations in memory (the 
addresses), of the instructions to be executed. The PC always contains the 
address of the next instruction to be executed. 


Programmable Read-Only Memory. 


Any message or symbol from the computer system informing the user of 
possible actions or operations. 


Non-graphic data which may be associated with database entities used to 
associate various characteristics and values with any subfigure or part. 
Properties may include such items as color, wire size, pin numbers, lug 
type, signal values, etc. A drill property is attached to each connect node 
of a PC component to indicate the size of the drill to be used by an NC drill- 
ing machine when drilling holes for specified leads. 


A formal set of convention or rules governing the format, timing, and error 
control to facilitate message exchange between two communicating pro- 
cesses. Also included are the electrical, mechanical and functional 
characteristics of the communications link. 


Pseudo-Instructions The data read into the instruction register from the maintenance control 


PTP 
PTR 


PTT (Post, 
Telephone and 


panel. 
Paper Tape Punch. 
Paper Tape Reader. 


The governmental agency that functions as the communications common 
carrier in most areas of the world except North America. 


Telegraph Authority) 


Puck 


A manually operated directional control on a large interactive surface. 


G-33 


The information and drawings contained herein are the sole property of Computervision 
Corporation. Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
express written consent of Computervision. 


Pulse Code 
Modulation (PCM) 


Push Operation 


Quadratic 


Radix 


RAM 


Range 


Raster 


Read-Only Memory 
(ROM) 


Real 

Real Time 
Processing 
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Reference 
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Regen File 


Register 
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Modulation of a pulse train in accordance with an 8-bit code. 
Writing a word into the top location of the next address logic stack, 
thereby pushing each word in the stack down. 


A branch of algebra dealing with equations involving terms of no more 
than the second degree. 


The base of a number system; the number of digit symbols required by a 
number system. 


Random Access Memory: access to data in which the next location from 
which data is to be obtained is not dependent on the location of the 
previously obtained data. This is in constrast to sequential access. 

The limits of a series; the distance or extent between possible extremes. 
The horizontal or vertical distance between two adjacent addressable 
points on a display surface. A system of intersecting lines covering a com- 


plete area. A unit of a coordinate system without reference to scale. 


Memory whose contents are not alterable by computer instructions. 


A floating point number used within FORTRAN program. 

Computation performed while a related or controlled physical activity is 
occurring so that the results of the computation can be used in guiding the 
process. 


In a protocol, that portion of the total characters or bits that can be 
eliminated without any loss of information. 


Text (often called component name) used to uniquely identify a compo- 
nent and to associate the component with a particular schematic element. 


CRT technique requiring periodic retransmission of the display image. 


File of display vectors necessary to paint the display of the drawing on a 
CRT. 


A special 16-bit data storage area. 
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Relation An aspect or quality that connects two or more like things or parts as 
being, belonging, or working together or as being of the same kind. 


Relative Layer A layer relative to that of the subfigure. If the RLAY5 modifier is used for a 
text node and the subfigure containing the text node is on layer 10, then 
the text will be placed on layer 15. 


Remote Station (Multipoint) synonymous with tributary station. (Point-to-point switched 
network) a station that can be called by the central station, or can call the 
central station if it has a message to send. 


Repaint Redraw a display image on an output device. In CADDS, a repaint is done 
from a REGEN file. 


Reset (or Clear) The state of a flip-flop when its Q output = 0 and its O output = 1. 


Resource Any means available to users, such as computational power, programs, 
data files, storage capacity, or a combination of these. 


Restart To resume execution of a program. 

Restore To renew, rebuild or to bring back to or put back into a former or original 
state. 

Reverse Channel A channel used for transmission of supervisory or error-control signals. 


The directional flow of these signal is opposite the direction in which infor- 
mation is being transferred. The bandwidth of this channel is usually less 
than that of the forward (information) channel. Used on two wire pairs. 


Reverse Interrupt In binary synchronous communications, a control character sequence 

(RVI) (DLE sequence) sent by a receiving station instead of ACK1 or ACKO to 
request premature termination of the transmission in progress. 

Ring Network A computer network in which each computer is connected to adjacent 
computers. 

ROM Read-Only Memory. 

Rotation The turning of a construction about an axis as if on a pivot. 

Router A program which automatically determines the routing path for the con- 


ductive interconnects between components on a printed circuit board. 


Routine A set of instructions arranged in proper sequence to cause a computer to 
perform a desired operation. 


G-35 


The information and drawings contained herein are the sole property of Computervision 
Corporation, Use of this document is reserved exclusively for Computervision customers 
and personnel. Reproduction of this matter in whole or in part is forbidden without the 
express written consent of Computervision. 


Routing 
RTC 
Run 


Scale 
Scissor 
SDLC (Synchronous 


Data Link Control 


Secondary Station 


Section 
Sector 


Selecting 


Sequential Access 


Serial Transfer 


Serial Transmission 


Set 


Shape Fill 


Signal 


G-36 


To place interconnections on a printed circuit board. 
Real-Time-Clock. 
A single, continuous execution of a program. 


To change the magnitude of a variable(s) in a uniform way; the ratio of a 


real thing’s magnitude to the magnitude of the model. 


To remove parts of display elements which lie outside defined bounds, 
synonymous with clip. 


IBM's version of a bit-oriented data link control. Imbedded in SNA. 

A station selected to receive a transmission from the primary station. The 
assignment of secondary status Is temporary, under control of the primary 
station, and continues for the duration of a transmission. Compare with 
Primary Station. 

A division. 

A physical portion of a mass storage device. 


A process of inviting another station or node to receive data. Compare 
with Polling. 


Access is dependent on a previous access. 

The transfer of data one bit at a time. 

A method of transmission in which each bit of information is sent sequen- 
tially on a single channel rather than simultaneously as in parallel transmis- 


sion. 


A collection of similar items forming a unit; a group of elements having at 
least one property in common. 


When creating a ground plane of any other area of a PC board which is to 
be filled with copper, the user can define the boundary of the shape and 
the area will automatically be painted in, (filled) by the proper aperatures 
when the area is photoplotted. 


The name associated with common nodes of an electrical path. 
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Signal Element Each of the parts of a digital signal, distinguished from others by its dura- 
tion, position, and sense or by some of these features only. In start/stop 
operation, a signal element has a minimum duration of one-unit interval. If 
several unit intervals of the same sense run together, a signal element of 
duration of more than one-unit element may be formed. Signal elements 
may be start elements, information elements, or stop elements. 


Signal The operation that identifies the connection points of a net in a PC board. 

Highlighting ln CADDS the command required is IDENT NET. The board must have 
been merged with the net list, using MERGE NET, before highlighting. 

Signal Net See Net List. 

Signal To Noise Relative power of the signal to the noise within a channel, usually 

Ratio (SNR) measured in decibels. 


Silk Screen Diagram Shows the outline of the PC component. It may be used to obtain a 
pattern on the PC board by using the silk screen process. 


Simplex Mode Operation of a channel in one direction only with no reversal capability. 

Single Entity A type of geometric design rules check in which each individual entity is 
checked. 

SLU A Data General produced communications PC board replaced by CV's 
PCU. 


SNA (Systems Net-  1IBM’s software protocol for data communications among IBM computers 
work Architecture) and terminals. 


Software A set of programs, procedures, rules and associated documentation 
concerned with the operation of a data processing system. Contrast to 
hardware. 

Source A text file of commands written in computer language. Source must be 


compiled to generate machine recognizable instructions. Source can be 
understood by people but not by a computer. 


Specialized A company that provides private line communications services, e.g., 
~ Common Carrier voice, teleprinter, data, facsimile transmissions, etc. See also Common 
Carrier and Value Added Service. 


Start Bit | In start/stop transmission, the first element in each character, which 


serves to prepare the receiving equipment for the reception and registra- 
tion of a character. 
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Start of Header A communication control character used at the beginning of a character 


(SOH) 


Start of Text (STX) 


Start/Stop 
Transmission 


Station 


Stop Bit(s) 


Storage 


Stretch 


Stretch Part 


sequence which constitutes a machine-sensible address or routine infor- 
mation. Such a sequence is referred to as the heading. 


A communication control character which precedes a character sequence 
that is to be treated as an entity and entirely transmitted through to the 
ultimate destination. Such a sequence is referred to as text. STX may be 
used to terminate a character (heading) started by SOH. 


Asychronous transmission in which a group of code elements correspond- 
ing to a character signal is preceded by a start element and is followed by a 
stop element. EIA RS 404. 


The data terminal equipment from or to which messages are transmitted 
on a data link. It includes these elements which serve as souces or links for 
the messages, as well as those elements which control the message flow 
on the link, by means of data communications control procedures. 


In start/stop transmission, the last element in each character, to which ts 
assigned a minimum duration, during which the receiving equipment is 
returned to its rest condition in preparation for the reception of the next 
character. 


Pertaining to a device into which data can be entered, in which it can be 
held, and from which it can be retrieved at a later time. 


To expand or shorten, to alter; to extend beyond original limits. 


The ability to stretch or shrink a part and have the values of the appropriate 
dimensions automatically updated to new values. 


String A series of continuous straight line segments. 

Stylus An instrument used for writing, marking, or incising. 

Subfigure The placement of one drawing into another as a reference without 
duplicating the display elements. The instance refers to the figure in the 
parts library. 

Subprogram A program or a sequence of instructions that can be called to perform the 
same task, though perhaps on different data, at different points in a pro- 
gram, or even in different programs. It may be a function. 

Subroutine Subroutine is another term for subprogram. 
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A plane or two-dimensional locus of points. 


Surface Machining _ The ability to output 3-, 4-, and 5-axis NC toolpaths using the present 


Switched Line 


Symbols 


Synchronous 


Synchronous Idle 
(SYN) 


Synchronous 
Transmission 


Syntax 


Sysgen 


Tag 


Tariff 


Task 


three-dimensional surface definition capabilities of CADDS, i.e., ruled sur- 
faces, tabulated cylinders, surfaces of revolution etc. 


A communications link for which the physical path may vary with each 
usage, e.g., the dial-up telephone network. 


A representation of something by reason of relationship, association, or 
convention; an arbitrary or conventional sign used in writing or printing 
relating to a particular field to represent operations quantities, elements, or 
relationships. 


Pertaining to related events where all changes occur simultaneously over 
indefinite timed intervals. 


Character used as a time fill in the absence of any data or control character 
to maintain synchronization (character phase) following each line 
turnaround in Bisync and DDCMP. DLE-SYN is the time fill in BISYNC 
transparent mode. 


Transmission in which the data characters and bits are transmitted at a 
fixed rate with the transmitter and receiver synchronized. This eliminates 
the need for start/stop elements, thus providing greater efficiency. 
Compare with Asynchronous Transmission. 


The structure of expressions in a language and the rules governing the 
structure of a language. 


A software system; the process of grouping object modules together to 
form a software system. 


To attach as an addition. To supply with an identifying number. 


1. A published rate for services provided by a common or specialized 
Carrier. 


2. The means by which regulatory agencies approve such services. The 
tariff is a part of a contract between customer and carrier. 


A specific portion of memory, assigned to the user, which is capable of 
executing software programs. 
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Trademark of Teletype Corporation. Usually refers to one of their series of 
teleprinters. 


A public teletypewriter exchange (switched) service in the United States 
and Canada formerly belonging to AT&T Company which is now owned 
by the Western Union Telegraph Company. Both Baudot and ASCIl- 
coded machines are used. 


An input/output device with a keyboard that uses ADCII character data 
(such as the Telewriter or the interactive display terminal). 


Used to enter commands or to print out system messages. It has a 
typewriter-style keyboard, it can print out a hard copy, and may be used as 
a command device. 


A western Union world-wide teletype-writer exchange service that uses 
the public telegraph network Baudot equipment is used. 


The name given to the pricing arrangement by AT&T in which many voice- 
grade telephone lines are leased as a group between two points. 


A gauge, pattern, or mold used as a guide to the form of a piece being 
made. 


In binary synchronous communications, a control character sequence 
(STX ...ENQ) sent by a transmitting station to either indicate a delay in 
transmission or to initiate an abort of the transmission in progress. 


Preliminary, not fully worked out or developed. 


An 1/O device, such as a Telewriter, that includes a keyboard and a display 
mechanism. A terminal is used as the main communication device 
between the processor and the operator. 


In ASCII, as well as in general communications usage, a character 
sequence is treated as an entity if preceded by a SOT and followed by an 
EOT control character. 


A file containing text. A text file may be created by the user with the EDIT 
commands or it may be created automatically by a CADDS command such 
as LIST NET. 
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Text Node (TNOD) 


Thickness 


Three-Dimensional 


(3D) 


Time-Division 


Toggle 


Toolpath 


Touch Tone 


Transformation 


Transform Space 


Translate 
Transparent 


Transparent Mode 


Trap 


Trap Size 


A location shown graphically as a shown graphically as a triangle (A) 
which contains default parameters for subsequent placement of nodal 
text. A text node may be associated with a connect node, several connect 
nodes, or a nodal subfigure or may stand alone. 


As applied to text, thickness is the line width and is controlled by the aper- 
ture on the photo-plotter wheel. 


A form consisting of length, width, and depth. A cube is three- 
dimensional. 


A system of multiplexing in which channels are established by connecting 
terminals one at a time at regular intervals by means of an automatic 
distribution. 


The use of switches located on an operator's console to enter data into the 
computer memory. 


The center line of an NC cutting or drilling tool in motion for a specific 
cutting operation. 


AT&T registered trademark for pushbutton dialing. The signaling form is 
multiple tones. 


The operation of changing, as by rotation or mapping, one configuration 
into another in accordance with a mathematical rule. See move. 


Display image with a coordinate frame of reference other than the part 
database. Contrast with Model Space. 


To move or change from one place to another. 

Having the property of invisibility. 

Transmission of binary data with the recognition of most control 
characters suppressed. In binary synchronous communications, entry to 
and exit from the transparent mode is indicated by the sequences Data 


Link Escape (DLE)-STX and DLE-EXT, ETB, ITB, ENQ. 


An automatic transfer of control to a known location; to catch or take in as 
if in a trap; an imaginary square about a digitized location. 


One-half the size of the imaginary square forming the trap. 
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A table that stores tentative paths as the router performs its iterations. 


A station, other than the control station, on a centralized multipoint data 
communications system which can communicate only with the control 
station when polled or selected by the control station. 


The reduction of precision by ignoring one or more of the least significant 
digits, e.g., 3.14159 truncated to four decimal digits is 3.141. 


A single circuit between two points, both of which are switching centers or 
individual distribution points. 


Pertaining to a computer system sold in a ready-to-use state. 

A number used to represent the negative of a given value in many com- 
puters, formed from the given binary value by changing all 1’s to 0’s and all 
O's to 1’s and then adding 1. 

A form consisting of length and width. A plane is two-dimensional. 

A mode of data link operation in which data may be transmitted in both 
directions, one way at a time. Also called half-duplex operation. 

A mode of data link operation in which data may be transmitted 
simultaneously in both directions over two channels. NOTE: One of the 
channels is equipped for transmission in one direction while the other is 
equipped for transmission in the opposite direction. The channels may be 
two two-wire pairs or one frequency divided two-wire pair. Also called full- 
duplex and duplex. 


see Teletypewriter Exchange Service. 


Universal Asynchronous Receiver/Transmitter: LSI circuit for start/stop 
serial data transfer. 


A single quantity regarded as a whole in calculations; a determinate quan- 
tity adopted as a standard of measurement. 


To detach. 


Universal Synchronous-Asynchronous Receiver/ Transmitter. 


— See ASCII. 
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One who operates the system. 


The state of the MMPU when it maps memory addresses. The mapper 
RAM cannot be loaded when the MMPU is in user mode (cf supervisor 
mode) 


Universal Synchronous Receiver Transmitter. 


A communication service utilizing communication common carrier net- 
works for transmission and providing added data services with separate 
additional equipment. Such added service features may be store and for- 
ward message switching, terminal interfacing, and host interfacing. 


A quantity that has magnitude and direction and is commonly represented 
by a directed line segment whose length represents the magnitude and 
whose orientation in space represents the direction. 


A connection between a source and a sink in a network that may be 
realized by different circuit configurations during transmission of a 
message. Also called a logical circuit. 


The layer of the PC board drawing which contains the connections that are 
predominately vertical. 


A check or parity bit added to each character in a message such that the 
number of bits in each character, including the parity bit, is odd (odd parity 
or even (even parity). 
Video Generator Unit. 
A Via is a means of passing from one layer or side of a printed circuit board 
to the other. A prohibition prevents automatic routing through the area of 


a Via. 


Being, relating to, or used in the transmission or reception of an image on 
a Cathode Ray Tube (CRT). 


A pictorial representation. 

This feature gives a CADDS user the ability to logically assign several 
different windows or views of a part’s geometry to one physical device, 
i.e., a drawing may be divided up into many views and each assigned a 


different location on the LIS surface. 


View space is analagous to transform space. 
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Capable of being seen; exposed to view. 


A channel used for speech transmission usually with an audio frequency 
range of 300-3400 Hertz. It is also used for transmission of analog and 
digital data. Up to 10,000 bits per second can be transmitted on a voice- 
grade channel. 


Space occupied as measured in cubic units; the amount of a substance 
occupying a particular volume. | 


In binary synchronous communications, this DLE sequence Is sent by a 
receiving station to indicate that it is temporarily not ready to receive. 


Something that alerts or serves to alert; to call to one’s attention a possible 
danger. 


A service provided by telephone companies in the United States that 
permits a customer to make calls to or from telephones in specific zones 
for a flat monthly charge. The monthly charges are based on size of the 
zone instead of number of calls. WATS may be used on a measured-time 
or full-time basis. 


Communications channel having a bandwidth greater than a voice grade 
channel. 


Measurement taken at right angles to the length and depth. 

A bounded area, within a display image, that contains a scissored subset 
of the displayable data. It is a framework that resembles or suggests a 
window. 


A wire run with only two connections. 


A wire run list containing only two connections in each wire run (Wire). It 
may also be called a To-From list. 


Alphanumeric designation of wire net. In CADDS, a wirename is 
represented like a net name. 


Subset of electrical connections in a logical net having the same 
characteristics and common identifiers. No physical order of connection is 
implied. A wire net may contain bullets. 


Wire Net List 
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Wire Run 
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Subset of net list which lists the electrical connections of a wire net. The 
order listed does not imply physical ordering. Bullets are not listed. 


Alphanumeric designation of a wire or wire run. In CADDS, a Wire number 
is represented a wire name. | 


A wire net implying physical order. Bullets cannot exist in a wire run. 


A wire net list which implies physical order. The order of the list is the con- 
nection order of the wire run. 


A diagram containing components, wire runs, wires, miscellaneous 
graphic and non-graphic information and text annotation. 


Sixteen binary digits, treated as a single unit in the Computervision 
CGP-200 and in many other computers. 


The condition of a storage device that allows data to be written on it. 
The condition of a storage device that prevents data being written on it. 
A CCITT recommendation designation. 

No horizontal movement. 


Movement restricted to either vertical or horizontal direction may not be 
changed until a full stop is reached in the original direction. 


No vertical movement. 


A CV coding compatible with Zilog Model Z-80 microprocessor (chips); 
used on the PCU card. 


The ability to specify a three-dimensional window, cube, for a drawing 
such that all elements which are outside the cube become invisible. This 
feature only affects visibility, no change is made to the database of the part 
or drawing. It is useful in editing cluttered or complex part geometry. 


To proportionately enlarge or decrease the size of the display entities by 
rescaling. 7 
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